Search the Texas TDLR active license list. query is a person or business name. license_type is the form code. For a useful search, send a type code such as AIRREF (air conditioning and refrigeration contractors).
GET https://api.piloterr.com/v2/tdlr/search?query=SMITH&license_type=AIRREF
Header: x-api-key.
Each page has 25 rows. You must send a name, a city, a county, or a ZIP. A blank license_type searches every type and is rarely useful. A detail URL belongs on /v2/tdlr/license and returns 400 here.
Search rows leave status, subtype, dba, and original_issue_date empty. Those fields are on the license endpoint.
query is optional when city, county, or postal_code is set. Example: SMITH.
license_type is optional on the request and required for a useful search. Example: AIRREF. ALL or a blank value searches every type. A code that is not 2 to 12 letters or digits returns 400.
city is optional. Example: Austin.
county is optional. Example: TRAVIS.
postal_code is optional. Example: 78701.
page is optional and defaults to 1. Example: 2.
At least one of query, city, county, or postal_code is required.
license_number is the public license, for example TACLA00000564E. detail_id is the TDLR detail key, for example AIRREF00000564. url is the SearchResultDetail link. Pass either detail_id or url to the license endpoint.
name is the licensee. business_name is the business when the list prints one in parentheses. expiration_date is the list date, such as 12/24/2026. county is the county. city, postal_code, and phone are filled when the list shows them, and are often null on this report.
license_type is the heading of the result set, for example Air Conditioning Contractors. license_type_code is the code taken from detail_id, for example AIRREF.
status, subtype, dba, original_issue_date are null on a normal list row. notes is an empty list. The license call fills them.
pagination.per_page is 25. pagination.page starts at 1. pagination.total_results is the "records retrieved" count. pagination.total_pages is that count divided by 25, rounded up.
pagination.next is a URL while page is below total_pages. On the last page next is null.
For SMITH and AIRREF the live list had 153 records and 7 pages. Page 1 and page 2 each had 25 distinct detail_id values and did not overlap. Page 7 had 3 rows and next was null.
- A general contractor in Fort Bend checks
AIRREF licenses named SMITH before hiring a subcontractor.
- A city permit desk lists air-conditioning contractors in Travis County with
county=TRAVIS and license_type=AIRREF.
- An insurer walks every 25-row page and flags
expiration_date values inside 90 days, then opens url because the list omits status.
- 400: no name, city, county, or ZIP, a bad license type code, a detail URL, or
page below 1.
- 404: no rows, or
page is past the last page.
- 401: missing API key.