Verify License

Verify state trade contractor license with low-latency persistent caching. Supports California (CSLB), Florida (DBPR), and Texas (TDLR).

post/v1/verify

Request

  • Base URL: https://licenseground.com (the document declares no server; this is the origin it was published from)
  • URL: https://licenseground.com/v1/verify
  • Auth: none declared

Headers

X-Agent-Keystring nullable
X-Agent-API-Keystring nullable

Request body

entity_namestring nullable

The business name or DBA to verify (e.g. 'Apex Roofing LLC'). At least entity_name or license_number must be provided.

state'CA' | 'FL' | 'TX' | 'NY' | 'MA' | 'IL' | 'AZ' | 'US' required
license_numberstring nullable

State license or certificate registration number (e.g., 'CCC1330999', '1058291', 'TACLA12345C').

trade'roofing' | 'hvac' | 'electrical' | 'plumbing' | 'general_contractor' | 'any'
citystring nullable

Optional city to filter geographic disambiguation.

Response

Successful Response

verifiedboolean required

True if the entity possesses an authentic, matching registration on the official state registry.

canonical_namestring required

Official legal business name registered with the state licensing board.

dba_namestring nullable

Registered Doing-Business-As (DBA) or fictitious business name if applicable.

license_numberstring required

Official state license/certificate identifier.

state'CA' | 'FL' | 'TX' | 'NY' | 'MA' | 'IL' | 'AZ' | 'US' required
trade_classificationstring required

State trade classification (e.g., 'C-39 Roofing', 'CCC Certified Roofing Contractor', 'TACLA HVAC').

trade_category'roofing' | 'hvac' | 'electrical' | 'plumbing' | 'general_contractor' | 'any'
status'ACTIVE_CURRENT' | 'INACTIVE' | 'EXPIRED' | 'SUSPENDED' | 'REVOKED' | 'PENDING' | 'DELINQUENT' | 'NOT_FOUND' required
is_activeboolean required

Helper boolean: True only if status is ACTIVE_CURRENT.

disciplinary_actionsinteger

Total count of historical or pending disciplinary actions/citations.

issue_datestring nullable

Date the license was originally issued (YYYY-MM-DD).

expiration_datestring nullable

Expiration date of the current license cycle (YYYY-MM-DD).

is_expiredboolean

True if expiration_date is in the past.

workers_comp_exemptboolean

True if the contractor filed an exemption claiming zero employees.

workers_comp_coveredboolean

True if active Workers' Compensation insurance policy is confirmed on file with the state board.

workers_comp_insurerstring nullable

Name of workers' comp insurance carrier, policy number, or status note.

bond_statusstring nullable

Contractor surety bond status (e.g. 'ACTIVE $25,000', 'EXEMPT', 'NOT_REQUIRED').

bond_companystring nullable

Surety company underwriting the contractor bond.

business_addressstring nullable

Principal place of business on official record.

citystring nullable
zip_codestring nullable
phonestring nullable
qualifying_agentstring nullable

Licensed individual qualifier, master, or primary officer (e.g. Master Electrician or RMO/RME).

grounding_confidencenumber required

Confidence score (0.0 to 1.0) indicating exactness of entity name match against registry records.

source_registrystring required

Official source registry name (e.g. 'CA Contractors State License Board (CSLB)').

source_urlstring nullable

Direct URL to official state verification record.

cachedboolean

True if served from low-latency persistent cache.

source_timestampstring

ISO 8601 timestamp when data was fetched or grounded.

Changes

No recorded changes to this operation across all 1 revision of this API.