Texas Professional License Scraper - TDLR Verification API

Search the official Texas Department of Licensing and Regulation (TDLR) Active License Data Search by license number, name prefix, program, city, county, or ZIP. Each found item links back to the official record and can include source-reported status, endorsement, expiration, original issue date, DBA/business name, and public-contracting restrictions.

Use it for Texas contractor-license checks, compliance review, licensed-business research, and lead qualification across electricians, HVAC contractors, tow operators, cosmetology/barber businesses, massage professionals, property-tax consultants, accessibility specialists, water-well professionals, and other TDLR programs.

Fast first run

An empty input uses a runtime-only exact fixture:

{}

It returns one active HVAC contractor record (license TACLA00000564E) with official detail evidence. The fixture is applied only when every substantive search field is blank, so it cannot contaminate a buyer's name, location, or license-number search.

Equivalent explicit input:

{
  "licenseType": "AIRREF",
  "licenseNumber": "564",
  "fetchDetails": true,
  "maxResults": 1
}

Example found item

{
  "setupStatus": "found",
  "licenseProgramCode": "AIRREF",
  "licenseProgram": "Air Conditioning/Refrigeration Contractor",
  "licenseNumber": "TACLA00000564E",
  "licenseType": "AE",
  "endorsement": "AE",
  "name": "SMITH, JAMES CHARLES JR",
  "businessName": "JIMMY'S AIR CONDITIONING & HEATING",
  "dba": "JIMMY'S AIR CONDITIONING & HEATING",
  "county": "FORT BEND",
  "expirationDate": "12/24/2026",
  "licenseStatus": "Active",
  "originalIssueDate": "08/16/1984",
  "publicContractingRestriction": "No Public Contracting",
  "detailRetrieved": true,
  "detailUrl": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?...",
  "source": "Texas Department of Licensing and Regulation Active License Data Search",
  "retrievedAt": "2026-07-26T07:38:10Z"
}

Dates and status above are examples from the source and can change.

Inputs

Field	Description
licenseType	TDLR program code, such as AIRREF (HVAC), ELCTRC (electricians), TOWOPR (tow operators), or RASPCL (accessibility specialists).
licenseNumber	Exact numeric or source-displayed license number. Common prefixes/suffixes are normalized to TDLR's eight-digit lookup.
name	Licensee or business-name prefix, minimum two characters.
city / county	Exact location value used by the official portal.
zip	Five-digit ZIP code.
fetchDetails	Fetch official detail pages for status, type/endorsement, issue date, DBA/business name, and restrictions when available. Default true.
maxResults	Total dataset-item cap, 1-500. Default 1.

Common programs are available in the input menu. TDLR changes its program catalog over time, so API users should use the current official program code when searching a less common category.

Explicit outcomes

A run returns a dataset item even when no license row is found:

• found — one or more source-linked records matched.
• no_match — no active-license result matched the supplied criteria.
• invalid_input — input validation failed before searching.
• source_unavailable — the official source could not complete the request.

A no_match result is not proof that a person or business is unlicensed. It is bounded to the selected TDLR program, supplied criteria, active-license search, and retrieval time. The subject may appear under another program/name or another licensing authority.

Pricing and limits

The default returns one paid dataset item. At the current $0.002 per item plus the $0.0001 start event, its maximum first-run charge is $0.0021. maxResults is a total cap, and the actor honors Apify's maximum-total-charge budget before searching.

Broad searches can return up to 500 items. Detail enrichment uses bounded concurrency, and output is persisted in batches.

Evidence boundaries

TDLR output is point-in-time public administrative evidence. Source status, expiration, endorsement, names, locations, and restrictions can change. A returned row does not by itself prove:

• identity or that a similarly named person/business is the intended subject;
• good standing, disciplinary clearance, insurance, or bonding;
• authorization for a specific scope of work;
• contracting eligibility or absence of restrictions;
• complete due diligence across other Texas agencies or local authorities.

Review the linked official record and applicable TDLR program rules before making compliance, hiring, contracting, or eligibility decisions.

Official source: TDLR Active License Data Search