Contractor License Lookup & Verification API — CA, FL, IL, NYC, OR, TX, WA

Verify a contractor license by license number or business name in seconds. Give this actor a licence number or a business name and it returns one normalized JSON record per licence — status, trade classifications, expiration date, and, where the state publishes them, the surety bond and insurance policies.

Every record comes from the licensing board's own public records — CSLB, DBPR, IDFPR, DCWP, CCB, TDLR, L&I. Nothing is inferred, nothing is padded, and every record carries a link back to the source row.

What you get

Field	Meaning
status	Normalized: ACTIVE, EXPIRED, SUSPENDED, REVOKED, INACTIVE, UNKNOWN
status_raw	The board's exact wording, never modified
business_name, qualifier_name	The company and the individual who holds the licence
classifications	Trade codes — CA's B / C-10, WA's CC, NYC's GENERAL CONTRACTOR
issue_date, expiration_date	Where the board publishes them
bond	Surety, bond number, amount (CA, OR, WA)
liability_insurance	Carrier, policy number, limit (OR, WA)
workers_comp	Carrier and policy (CA); exemption status only (OR)
disciplinary_actions	Case number, type, date, reason (IL)
address	Business address as filed
source_url, source_name, retrieved_at	Provenance on every single record
data_completeness	Which fields this board actually supplies

That last field matters more than it looks. State boards publish wildly different things, so a null bond is ambiguous on its own. data_completeness tells you whether it means "this contractor has no bond" or "this board doesn't publish bonds at all".

Coverage, and its limits

State	Board	Read this before you build on it
CA	CSLB	Full coverage. Name searches omit the qualifier; number lookups include it.
FL	DBPR	Full coverage. No bond or insurance data published.
IL	IDFPR	Roofing contractors only — the one construction trade Illinois publishes. The only state here with disciplinary actions.
NY	NYC DCWP + DOB	New York City only. New York State issues no statewide contractor licence. Covers home improvement contractors, general contractors, master plumbers and electrical contractors.
OR	CCB	Full coverage, including bond and liability insurance.
TX	TDLR	No general contractors. Texas licenses electricians, HVAC, irrigators and similar trades; general contracting is unregulated at state level.
WA	L&I	Full coverage, including bond and liability insurance.

These caveats are here rather than in the fine print because finding out after you have integrated is worse than knowing now.

Input

{
  "state": "CA",
  "licenseNumbers": ["1000004"],
  "names": ["ACME CONSTRUCTION"],
  "limit": 25,
  "includeNotFound": false
}

• state — one of CA, FL, IL, NY, OR, TX, WA.
• licenseNumbers — exact numbers. Dashes and spaces are ignored.
• names — partial, case-insensitive business or qualifier name search.
• limit — how many licences to return per name (1–100).
• includeNotFound — add a row for queries that matched nothing. You are never charged for these rows.

Output

One dataset row per licence:

{
  "query": "1000004",
  "query_type": "license_number",
  "state": "CA",
  "license_number": "1000004",
  "status": "ACTIVE",
  "status_raw": "Active",
  "business_name": "SOUTH COAST CONSTRUCTION & DEVELOPMENT",
  "classifications": [{ "code": "B", "description": "General Building Contractor" }],
  "expiration_date": "2027-05-31",
  "bond": { "surety_company": "...", "bond_number": "...", "amount_usd": 25000 },
  "source_url": "https://...",
  "source_name": "California CSLB",
  "retrieved_at": "2026-08-03T00:00:00Z",
  "data_completeness": { "bond": true, "disciplinary_actions": false }
}

Pricing

Free during beta. No charge per run or per record while pricing is being finalized.

Who this is for

• Lenders and insurers verifying a contractor before extending credit or writing a policy
• Marketplaces vetting contractors at signup instead of trusting a self-reported number
• Property managers and GCs checking a sub is still licensed before work starts
• Compliance teams who need provenance on every check, which is why source_url and retrieved_at are on every record rather than available on request

Also available as a REST API

The same backend is on RapidAPI as Contractor License Verification if you would rather call it directly. Full schema and per-state coverage notes at swanum.com/states.

Data sources

California CSLB · Florida DBPR · Illinois IDFPR · NYC DCWP and DOB · Oregon CCB · Texas TDLR · Washington L&I — all public records, refreshed at most 24 hours old (California weekly).

FAQ

How do I check if a contractor is licensed? Give this actor the licence number if you have it, or the business name if you don't. Both return the same normalized record, so nothing downstream needs to know which one you used.

Can I look up a contractor license by company name instead of a number? Yes — the names input does a partial, case-insensitive search and can return multiple matching licences per name.

Does this include contractor complaints or disciplinary actions? Illinois publishes them and this actor returns them. The other six states don't publish disciplinary data at the board level, so there's nothing to return — see the coverage table above for exactly what each board does and doesn't publish.

Is there a free way to try contractor license verification? Yes — this actor is free during beta. See Pricing above.

Which states does this cover? CA, FL, IL (roofing contractors only), NYC, OR, TX, and WA. New York is New York City only; New York State itself issues no statewide contractor licence.