Fetch one TDLR license. The response is a flat object. It uses the same fields as a search row and fills the values the list leaves empty: status, subtype, DBA, original issue date, and notes.
GET https://api.piloterr.com/v2/tdlr/license?query=AIRREF00000564
Header: x-api-key.
query is required. Example: AIRREF00000564. The SearchResultDetail URL from search also works: https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000564.
detail_id and license_number match the search row. For this example they are AIRREF00000564 and TACLA00000564E.
query is required. Example: AIRREF00000564, or the SearchResultDetail URL from results[].url.
license_number, detail_id, url, name, business_name, county, expiration_date, license_type, and license_type_code match the search row. The type label on the detail page can be longer than the list heading. This record says Air Conditioning/Refrigeration Contractor here and Air Conditioning Contractors on the list.
status is the license status, for example Active. subtype is the type code printed on the card, for example AE. dba is the doing-business-as name. On this record it matches business_name. original_issue_date is the first issue date, for example 08/16/1984.
notes is a list of strings. This record includes No Public Contracting. city, postal_code, and phone stay null when the detail page does not print them.
- A property manager confirms
TACLA00000564E is Active and reads the DBA before scheduling a repair.
- A bid reviewer checks
notes for a line such as No Public Contracting before awarding a public job.
- A compliance file stores
original_issue_date and subtype, which the search row does not include.
- 400:
query is not a detail id or a SearchResultDetail URL.
- 404: the page has no license card.
- 401: missing API key.