Skip to main content
Piloterr
Back to library

TDLR License API

Fetch one TDLR license by detail id or SearchResultDetail URL, including status, subtype, DBA, and notes.

Active1 credit = 1 requestGET/v2/tdlr/license

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to 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.

ParametersLink to Parameters

query is required. Example: AIRREF00000564, or the SearchResultDetail URL from results[].url.

Response fieldsLink to 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 casesLink to 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 codesLink to Error codes

  • 400: query is not a detail id or a SearchResultDetail URL.
  • 404: the page has no license card.
  • 401: missing API key.

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included