# TDLR License ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/tdlr/license` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/tdlr-license | ## Description Fetch one TDLR license by detail id or SearchResultDetail URL, including status, subtype, DBA, and notes. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/tdlr/license' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### TACLA00000564E ```json { "dba": "JIMMY'S AIR CONDITIONING & HEATING", "url": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000564", "city": null, "name": "SMITH, JAMES CHARLES JR", "notes": [ "No Public Contracting" ], "phone": null, "county": "FORT BEND", "status": "Active", "subtype": "AE", "detail_id": "AIRREF00000564", "postal_code": null, "license_type": "Air Conditioning/Refrigeration Contractor", "business_name": "JIMMY'S AIR CONDITIONING & HEATING", "license_number": "TACLA00000564E", "expiration_date": "12/24/2026", "license_type_code": "AIRREF", "original_issue_date": "08/16/1984" } ``` ## Documentation ## Overview 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`. ## Parameters `query` is required. Example: `AIRREF00000564`, or the SearchResultDetail URL from `results[].url`. ## Response fields `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. ## Use cases - 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. ## Error codes - 400: `query` is not a detail id or a SearchResultDetail URL. - 404: the page has no license card. - 401: missing API key.