Skip to content
DatasetsBuilding permitsContractor licencesCertificates of occupancyBuilding inspectionsCode violations and complaintsDevelopment pipelineCoverage & freshnessDatasets overview
ProductsAPIWeb searchEnterprise export contactAlerts & webhooksProperty historyAI connector (MCP)
SolutionsInsuranceLenders & CREReal estateRoofingHVACSolarContractors
PricingDocs
ResourcesBlogCompareGlossaryMethodologyStatus
Sign inGet free API key

DATASET API

Contractor licences

Board-published licence identifiers, with optional Pro details.

Explore coverage & freshness
What 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

ME: 0 recordsMEVT: 2,020 recordsVTNH: 0 recordsNHWA: 161,452 recordsWAID: 0 recordsIDMT: 0 recordsMTND: 0 recordsNDMN: 228,332 recordsMNWI: 0 recordsWIMI: 0 recordsMINY: 85,834 recordsNYMA: 0 recordsMAOR: 62,157 recordsORNV: 19,179 recordsNVWY: 0 recordsWYSD: 0 recordsSDIA: 22,177 recordsIAIL: 17,976 recordsILIN: 0 recordsINOH: 12,409 recordsOHPA: 37,921 recordsPANJ: 18,004 recordsNJCT: 196,564 recordsCTRI: 0 recordsRICA: 244,408 recordsCAUT: 0 recordsUTCO: 20,840 recordsCONE: 0 recordsNEMO: 1,233 recordsMOKY: 0 recordsKYWV: 0 recordsWVVA: 83,802 recordsVAMD: 3,366 recordsMDDE: 23,190 recordsDEAZ: 0 recordsAZNM: 0 recordsNMKS: 0 recordsKSAR: 0 recordsARTN: 0 recordsTNNC: 0 recordsNCSC: 0 recordsSCDC: 20,497 recordsDCOK: 5,784 recordsOKLA: 0 recordsLAMS: 0 recordsMSAL: 11,088 recordsALGA: 0 recordsGAAK: 0 recordsAKHI: 0 recordsHITX: 36,477 recordsTXFL: 283,240 recordsFL
AK
AL
AR
AZ
CA
CO
CT
DC
DE
FL
GA
HI
IA
ID
IL
IN
KS
KY
LA
MA
MD
ME
MI
MN
MO
MS
MT
NC
ND
NE
NH
NJ
NM
NV
NY
OH
OK
OR
PA
RI
SC
SD
TN
TX
UT
VA
VT
WA
WI
WV
WY

40 sources shown

SourceStateRecordsData throughCurrencyFields published somewhere in rosterRoster fetched (not data through)
FL DBPRFL264,969Not published / not measuredNot MeasuredDiscipline2026-11-06 to 2026-11-06
CA CSLBCA244,4082026-11-05CurrentBond, Workers' comp, Discipline2026-11-06 to 2026-11-06
MN DLIMN228,332Not published / not measuredNot MeasuredDiscipline2026-11-06 to 2026-11-06
CT DCPCT196,5642026-11-05CurrentNo Pro fields measured2026-11-06 to 2026-11-06
WA LNIWA161,452Not published / not measuredNot MeasuredBond, Insurance, Discipline2026-11-06 to 2026-11-06
VA DPORVA83,802Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
OR CCBOR56,607Not published / not measuredNot MeasuredBond, Insurance, Workers' comp2026-11-06 to 2026-11-06
NYC DOBNY49,995Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
PHL LIPA30,004Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
DC DLCPDC20,497Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
TX TDLR ACRTX20,477Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
NV NSCBNV19,179Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
NYC DCWPNY18,928Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
FL DBPR ELECFL18,271Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
IA DIALIA18,250Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
NJ DCANJ18,004Not published / not measuredNot MeasuredDiscipline2026-11-06 to 2026-11-06
CO DORACO17,757Not published / not measuredNot MeasuredDiscipline2026-11-06 to 2026-11-06
TX TDLR ELECTX15,923Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
NY DOLNY15,138Not published / not measuredNot MeasuredWorkers' comp, Discipline2026-11-06 to 2026-11-06
DE DORDE14,086Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
OH OCILBOH12,409Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
CHICAGO GCIL11,674Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
AL GCBAL11,088Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
DE DPRDE9,104Not published / not measuredNot MeasuredDiscipline2026-11-06 to 2026-11-06
PGH PLIPA7,917Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
OK CIB ROOFOK5,784Not published / not measuredNot MeasuredInsurance, Workers' comp2026-11-06 to 2026-11-06
OR BCDOR5,550Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
IA EEBIA3,927Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
CHICAGO ELECIL3,196Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
BOULDER COCO3,083Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
MD MOCO NHBMD2,550Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
VT OPRVT2,020Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
BUFFALO DPISNY1,773Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
CHICAGO PLUMBIL1,298Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
MO ELECMO1,233Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
CHICAGO MASONIL1,188Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
MD MOCO FIREMD816Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
IL CDBIL578Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
TX TDLR SOLARTX77Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06
CHICAGO ELEVIL42Not published / not measuredNot MeasuredNo Pro fields measured2026-11-06 to 2026-11-06

Sources on hold

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.

FieldTypeDescriptionAccess
sourcestringSource as returned by the API. Missing source values may be null.Contractor licensing
record_kindstringRecord Kind as returned by the API. Missing source values may be null.Contractor licensing
record_notestring | nullRecord Note as returned by the API. Missing source values may be null.Contractor licensing
issuing_statestringIssuing State as returned by the API. Missing source values may be null.Contractor licensing; identifier also available free on contractor records where held
license_numberstring | nullLicense Number as returned by the API. Missing source values may be null.Contractor licensing; identifier also available free on contractor records where held
namestring | nullName as returned by the API. Missing source values may be null.Contractor licensing
license_typestring | nullLicense Type as returned by the API. Missing source values may be null.Contractor licensing
classificationstring | nullClassification as returned by the API. Missing source values may be null.Contractor licensing; identifier also available free on contractor records where held
business_typestring | nullBusiness Type as returned by the API. Missing source values may be null.Contractor licensing
is_individualbooleanIs Individual as returned by the API. Missing source values may be null.Contractor licensing
statusstring | nullStatus as returned by the API. Missing source values may be null.Contractor licensing
status_normalizedstring | nullStatus Normalized as returned by the API. Missing source values may be null.Contractor licensing
status_derivedboolean | nullStatus Derived as returned by the API. Missing source values may be null.Contractor licensing
status_detailstring | nullStatus Detail as returned by the API. Missing source values may be null.Contractor licensing
in_forceboolean | nullIn Force as returned by the API. Missing source values may be null.Contractor licensing
issue_datedate | nullIssue Date as returned by the API. Missing source values may be null.Contractor licensing
effective_datedate | nullEffective Date as returned by the API. Missing source values may be null.Contractor licensing
expiration_datedate | nullExpiration Date as returned by the API. Missing source values may be null.Contractor licensing
inactive_datedate | nullInactive Date as returned by the API. Missing source values may be null.Contractor licensing
citystring | nullCity as returned by the API. Missing source values may be null.Contractor licensing
statestring | nullState as returned by the API. Missing source values may be null.Contractor licensing
zipstring | nullZip as returned by the API. Missing source values may be null.Contractor licensing
source_updated_datedate | nullSource Updated Date as returned by the API. Missing source values may be null.Contractor licensing
as_ofdate | nullAs Of as returned by the API. Missing source values may be null.Contractor licensing
matchstring | nullMatch as returned by the API. Missing source values may be null.Contractor licensing
bond_companystring | nullBond Company as returned by the API. Missing source values may be null.Contractor licensing Pro
bond_amountnumber | nullBond Amount as returned by the API. Missing source values may be null.Contractor licensing Pro
bond_effective_datedate | nullBond Effective Date as returned by the API. Missing source values may be null.Contractor licensing Pro
bond_expiration_datedate | nullBond Expiration Date as returned by the API. Missing source values may be null.Contractor licensing Pro
bond_cancellation_datedate | nullBond Cancellation Date as returned by the API. Missing source values may be null.Contractor licensing Pro
insurance_companystring | nullInsurance Company as returned by the API. Missing source values may be null.Contractor licensing Pro
insurance_amountnumber | nullInsurance Amount as returned by the API. Missing source values may be null.Contractor licensing Pro
insurance_expiration_datedate | nullInsurance Expiration Date as returned by the API. Missing source values may be null.Contractor licensing Pro
workers_comp_typestring | nullWorkers Comp Type as returned by the API. Missing source values may be null.Contractor licensing Pro
workers_comp_companystring | nullWorkers Comp Company as returned by the API. Missing source values may be null.Contractor licensing Pro
workers_comp_expiration_datedate | nullWorkers Comp Expiration Date as returned by the API. Missing source values may be null.Contractor licensing Pro
discipline_flagboolean | nullDiscipline Flag as returned by the API. Missing source values may be null.Contractor licensing Pro
discipline_detailstring | nullDiscipline 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"
    }
  ]
}

Authentication, pagination and response fields

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.

PlanBase planContractor licensingContractor licensing Pro
Free$0Not availableNot available
Indie$29/mo or $290/yrNot availableNot available
Hobbyist$39/mo or $390/yrNot availableNot available
Developer$79/mo or $790/yrAdd-on $19/mo or $190/yrAdd-on $29/mo or $290/yr
Business$149/mo or $1,490/yrIncludedAdd-on $29/mo or $290/yr
Scale$499/mo or $4,990/yrIncludedIncluded

Compare plan limits.

Choose your plan in the dashboard

Ways to use this dataset

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.