DATASET API
Contractor licences
Board-published licence identifiers, with optional Pro details.
Explore coverage & freshnessWhat this dataset covers
PermitStack's contractor-licensing dataset contains 1,597,950 licence and registration records from 40 loaded board rosters. It joins licence identifiers to board-published status and dates; Pro adds bond, insurance, workers' compensation and discipline fields where published. It is not a live board verification. The newest source-record update date supplied by a board is 2026-11-05; Rosters without a usable held update date have unknown data-through dates. A newest-row date does not establish the currency of every licence in a roster.
Coverage summary last measured: 2026-11-06. Record data-through dates are shown separately for each source.
Facts checked November 18, 2026. 16:00:04.322463+00:00 (UTC).
Coverage and freshness
40 sources shown
| Source | State | Records | Data through | Currency | Fields published somewhere in roster | Roster fetched (not data through) |
|---|---|---|---|---|---|---|
| FL DBPR | FL | 264,969 | Not published / not measured | Not Measured | Discipline | 2026-11-06 to 2026-11-06 |
| CA CSLB | CA | 244,408 | 2026-11-05 | Current | Bond, Workers' comp, Discipline | 2026-11-06 to 2026-11-06 |
| MN DLI | MN | 228,332 | Not published / not measured | Not Measured | Discipline | 2026-11-06 to 2026-11-06 |
| CT DCP | CT | 196,564 | 2026-11-05 | Current | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| WA LNI | WA | 161,452 | Not published / not measured | Not Measured | Bond, Insurance, Discipline | 2026-11-06 to 2026-11-06 |
| VA DPOR | VA | 83,802 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| OR CCB | OR | 56,607 | Not published / not measured | Not Measured | Bond, Insurance, Workers' comp | 2026-11-06 to 2026-11-06 |
| NYC DOB | NY | 49,995 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| PHL LI | PA | 30,004 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| DC DLCP | DC | 20,497 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| TX TDLR ACR | TX | 20,477 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| NV NSCB | NV | 19,179 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| NYC DCWP | NY | 18,928 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| FL DBPR ELEC | FL | 18,271 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| IA DIAL | IA | 18,250 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| NJ DCA | NJ | 18,004 | Not published / not measured | Not Measured | Discipline | 2026-11-06 to 2026-11-06 |
| CO DORA | CO | 17,757 | Not published / not measured | Not Measured | Discipline | 2026-11-06 to 2026-11-06 |
| TX TDLR ELEC | TX | 15,923 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| NY DOL | NY | 15,138 | Not published / not measured | Not Measured | Workers' comp, Discipline | 2026-11-06 to 2026-11-06 |
| DE DOR | DE | 14,086 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| OH OCILB | OH | 12,409 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| CHICAGO GC | IL | 11,674 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| AL GCB | AL | 11,088 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| DE DPR | DE | 9,104 | Not published / not measured | Not Measured | Discipline | 2026-11-06 to 2026-11-06 |
| PGH PLI | PA | 7,917 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| OK CIB ROOF | OK | 5,784 | Not published / not measured | Not Measured | Insurance, Workers' comp | 2026-11-06 to 2026-11-06 |
| OR BCD | OR | 5,550 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| IA EEB | IA | 3,927 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| CHICAGO ELEC | IL | 3,196 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| BOULDER CO | CO | 3,083 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| MD MOCO NHB | MD | 2,550 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| VT OPR | VT | 2,020 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| BUFFALO DPIS | NY | 1,773 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| CHICAGO PLUMB | IL | 1,298 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| MO ELEC | MO | 1,233 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| CHICAGO MASON | IL | 1,188 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| MD MOCO FIRE | MD | 816 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| IL CDB | IL | 578 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| TX TDLR SOLAR | TX | 77 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
| CHICAGO ELEV | IL | 42 | Not published / not measured | Not Measured | No Pro fields measured | 2026-11-06 to 2026-11-06 |
Sources on hold
- TX_TSBPE (TX): on hold; excluded from the loaded coverage totals.
- IL_IDFPR_ROOF (IL): on hold; excluded from the loaded coverage totals.
Pro-field presence is measured per roster, not promised on every licence. Registration-only records identify the registry and are not evidence of permission to perform work. Roster fetch dates record collection, not when a board last changed each record.
Fields and access
Generated from the public OpenAPI response schema LicenseRecord. Licence endpoints require the add-on even when some identifiers are also available on free contractor records. Restricted licence fields are null and named in locked_fields below Pro. No contact fields are returned by licence endpoints.
| Field | Type | Description | Access |
|---|---|---|---|
source | string | Source as returned by the API. Missing source values may be null. | Contractor licensing |
record_kind | string | Record Kind as returned by the API. Missing source values may be null. | Contractor licensing |
record_note | string | null | Record Note as returned by the API. Missing source values may be null. | Contractor licensing |
issuing_state | string | Issuing State as returned by the API. Missing source values may be null. | Contractor licensing; identifier also available free on contractor records where held |
license_number | string | null | License Number as returned by the API. Missing source values may be null. | Contractor licensing; identifier also available free on contractor records where held |
name | string | null | Name as returned by the API. Missing source values may be null. | Contractor licensing |
license_type | string | null | License Type as returned by the API. Missing source values may be null. | Contractor licensing |
classification | string | null | Classification as returned by the API. Missing source values may be null. | Contractor licensing; identifier also available free on contractor records where held |
business_type | string | null | Business Type as returned by the API. Missing source values may be null. | Contractor licensing |
is_individual | boolean | Is Individual as returned by the API. Missing source values may be null. | Contractor licensing |
status | string | null | Status as returned by the API. Missing source values may be null. | Contractor licensing |
status_normalized | string | null | Status Normalized as returned by the API. Missing source values may be null. | Contractor licensing |
status_derived | boolean | null | Status Derived as returned by the API. Missing source values may be null. | Contractor licensing |
status_detail | string | null | Status Detail as returned by the API. Missing source values may be null. | Contractor licensing |
in_force | boolean | null | In Force as returned by the API. Missing source values may be null. | Contractor licensing |
issue_date | date | null | Issue Date as returned by the API. Missing source values may be null. | Contractor licensing |
effective_date | date | null | Effective Date as returned by the API. Missing source values may be null. | Contractor licensing |
expiration_date | date | null | Expiration Date as returned by the API. Missing source values may be null. | Contractor licensing |
inactive_date | date | null | Inactive Date as returned by the API. Missing source values may be null. | Contractor licensing |
city | string | null | City as returned by the API. Missing source values may be null. | Contractor licensing |
state | string | null | State as returned by the API. Missing source values may be null. | Contractor licensing |
zip | string | null | Zip as returned by the API. Missing source values may be null. | Contractor licensing |
source_updated_date | date | null | Source Updated Date as returned by the API. Missing source values may be null. | Contractor licensing |
as_of | date | null | As Of as returned by the API. Missing source values may be null. | Contractor licensing |
match | string | null | Match as returned by the API. Missing source values may be null. | Contractor licensing |
bond_company | string | null | Bond Company as returned by the API. Missing source values may be null. | Contractor licensing Pro |
bond_amount | number | null | Bond Amount as returned by the API. Missing source values may be null. | Contractor licensing Pro |
bond_effective_date | date | null | Bond Effective Date as returned by the API. Missing source values may be null. | Contractor licensing Pro |
bond_expiration_date | date | null | Bond Expiration Date as returned by the API. Missing source values may be null. | Contractor licensing Pro |
bond_cancellation_date | date | null | Bond Cancellation Date as returned by the API. Missing source values may be null. | Contractor licensing Pro |
insurance_company | string | null | Insurance Company as returned by the API. Missing source values may be null. | Contractor licensing Pro |
insurance_amount | number | null | Insurance Amount as returned by the API. Missing source values may be null. | Contractor licensing Pro |
insurance_expiration_date | date | null | Insurance Expiration Date as returned by the API. Missing source values may be null. | Contractor licensing Pro |
workers_comp_type | string | null | Workers Comp Type as returned by the API. Missing source values may be null. | Contractor licensing Pro |
workers_comp_company | string | null | Workers Comp Company as returned by the API. Missing source values may be null. | Contractor licensing Pro |
workers_comp_expiration_date | date | null | Workers Comp Expiration Date as returned by the API. Missing source values may be null. | Contractor licensing Pro |
discipline_flag | boolean | null | Discipline Flag as returned by the API. Missing source values may be null. | Contractor licensing Pro |
discipline_detail | string | null | Discipline Detail as returned by the API. Missing source values may be null. | Contractor licensing Pro |
Make your first request
Synthetic licence identifier example, not a captured response. Status, expiry and Pro values are available after authentication and are not reproduced on this public page.
curl
curl -H "X-API-Key: pk_your_key_here" \ "https://api.permit-stack.com/v1/licenses/lookup?license_number=EXAMPLE-0001&state=TX"
Python
import os
import requests
response = requests.get(
"https://api.permit-stack.com/v1/licenses/lookup?license_number=EXAMPLE-0001&state=TX",
headers={"X-API-Key": os.environ["PERMITSTACK_API_KEY"]},
timeout=30,
)
response.raise_for_status()
print(response.json())Response excerpt
{
"licenses": [
{
"source": "EXAMPLE_BOARD",
"issuing_state": "TX",
"license_number": "EXAMPLE-0001",
"classification": "GENERAL"
}
]
}Pricing by plan
Developer base plan: $79/month. Contractor licensing add-on: $19/month. Combined monthly cost: $98. With licensing Pro ($29/month), the combined monthly cost is $108. Pro replaces basic licensing.
Dataset add-ons share the base plan request limits and are managed on the same subscription. Pro includes basic licensing and replaces that add-on.
| Plan | Base plan | Contractor licensing | Contractor licensing Pro |
|---|---|---|---|
| Free | $0 | Not available | Not available |
| Indie | $29/mo or $290/yr | Not available | Not available |
| Hobbyist | $39/mo or $390/yr | Not available | Not available |
| Developer | $79/mo or $790/yr | Add-on $19/mo or $190/yr | Add-on $29/mo or $290/yr |
| Business | $149/mo or $1,490/yr | Included | Add-on $29/mo or $290/yr |
| Scale | $499/mo or $4,990/yr | Included | Included |
Ways to use this dataset
- Contractors: Match licence identifiers to the issuing board.
- Insurance: Review board-published bond, insurance and discipline fields where available.
Frequently asked questions
How current is a licence record?
The data-through column measures board-supplied update dates, not the roster fetch time. Missing dates remain unknown. Check the issuing board for decisions that require current status.
Do you show individuals' licence addresses?
No. Individual licensee street addresses, phone numbers and email addresses are withheld. Licence endpoints contain no contact fields for any licensee.
How does this compare with Shovels' contractor data?
Compare issuing boards and fields for your market. PermitStack offers a separate board-roster dataset, with basic licensing and Pro details; contractor-detail contact access is separate. See the dated comparison for vendor scope.