TX TDLR Licenses (tx-tdlr-licenses)

Search and verify Texas professional & trade licenses - the state's ~983k-license register across 100+ programs (electricians, cosmetologists, A/C technicians, barbers, tow operators, and more), free public data from the Texas Department of Licensing and Regulation.

This is a credentials and compliance data layer: verify a license is real and current, find who is licensed to do a job in your county, watch who is expiring or newly licensed, and read the state's daily changes feed.

Built for HR & compliance teams, credentialing and background-screen vendors, contractors and their insurers, staffing agencies, and market researchers - the question "is this license real, whose is it, and is it current?" answered against the official register.

What a record carries

Search rows carry the register essentials. A get (by license number) adds the live detail page: the license's real status and its original issue date, parsed from the state's detail record - not a derived guess.

Field	Meaning
licenseNumber	The license number (numbers repeat across types - a barber and an electrician can share one; each match is returned, flagged by type)
licenseType / subtype	Program and sub-code (e.g. electrician ME/JE/AE)
ownerName / businessName	The person / the business, as the register lists each
county	Where the licensee is registered
expirationDate / isExpired	Expiry and a derived current flag
status + originalIssueDate	On a get: the live detail fields (real status, first issue date)

Honest scope note: the register does not carry bond / restriction / disciplinary detail - that is simply not in TDLR's public record. What it does carry (real status, original issue date, expiry, county, names) is returned accurately rather than padded with fields that don't exist.

Typical questions it answers

• Verify a license - licenseNumber=223846 (auto-routes to a get): live status + original issue date.
• Who's licensed to do electrical work in my county? - licenseType=Journeyman Electrician + county=Travis.
• Renewals coming due - filter an expiryFrom / expiryTo 90-day window (electricians alone run ~326k records).
• What's the statewide mix? - aggregate=true (one row per license type / subtype / county with count + share).
• What changed today? - mode=changes: new licenses, expiring licenses, and field changes from the state's daily register.

Inputs (all optional)

Input	What it does
mode	search / get / aggregate / changes; blank auto-routes (license number -> get, else search)
licenseNumber	Exact number - returns every matching license (flagged by type) + live status & original issue date
licenseType	Program (electrician / cosmetology / barber / A/C tech...) or blank for all 100+
subtype	Program sub-code (e.g. ME, JE, AE, OP)
name	Licensee / business name, substring
county	County, substring
expiryFrom / expiryTo	Expiry window (renewal sweeps)
aggregate / groupBy	One row per license type / subtype / county with count + share
maxResults	Cap records (default 100)

Low cost

$0.001 per record - a tenth of a cent for a license row or aggregate group - with a per-run charge cap so no surprise bills.

~983k licenses across 100+ programs sit behind one query surface. Two source quirks are absorbed for you: the state republishes its full register as a ~187MB file every business day, so changes are pre-diffed and served to you as a lean daily feed rather than that file's bulk; and license numbers genuinely repeat across programs (a barber and an electrician can hold the same number), so every matching license is returned flagged by type instead of silently collapsed. You query clean license rows and expiry sweeps; the register's daily bulk and number collisions stay on our side.

Data source & freshness

• Source: data.texas.gov - TDLR license mirror (7358-krk7, Socrata SODA API, free public, no login) + TDLR's official daily register for the changes feed.
• Update cadence: daily - the state republishes its register every business day; changes reflects it.

License & disclaimer

MIT - see ./LICENSE.

Independent data service; not affiliated with or endorsed by the Texas Department of Licensing and Regulation. All license data is public state information. Verify any credential on the official TDLR site before relying on it.