licenses

Get License

Fetch a single license by its id.

Args: license_id: The license's internal UUID. repo: Injected LicenseRepository.

Returns: The matching license.

Raises: LicenseNotFoundError: If no license with that id exists (a 404).

get/licenses/{license_id}

Request

  • Base URL: https://api.licenscheck.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.licenscheck.com/licenses/{license_id}
  • Auth: none declared

Path parameters

license_idstring uuid required

Response

Successful Response

idstring uuid required

Internal UUID identifier for this license record.

contractor_namestring required

Individual contractor's name as registered with the state board.

business_namestring nullable required

Registered business name, if the license is held by a business rather than an individual.

license_numberstring required

The license number as issued by the state board.

license_type'general_contractor' | 'building_contractor' | 'residential_contractor' | 'air_conditioning_contractor' | 'electrical_contractor' | 'roofing_contractor' | 'plumbing_contractor' | 'pool_spa_contractor' | 'mechanical_contractor' | 'sheet_metal_contractor' | 'utility_excavation_contractor' | 'solar_contractor' | 'specialty_contractor' | 'pollutant_storage_contractor' | 'precision_tank_tester' | 'other' | 'unknown' required

Normalized contractor trade category.

Each state board has its own raw code vocabulary (e.g. Florida DBPR's "CBC", "RG", ...); each state's ingestion DAG maps its own codes onto this shared vocabulary. Folds a state's "statewide" vs "local" license classes (e.g. FL's Certified vs Registered) into the same category here -- that distinction isn't tracked separately (yet).

state'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' required

USPS two-letter abbreviation for each US state and the District of Columbia.

Mirrored in airflow/dags/common/enums.py (kept dependency-free of this app -- see CLAUDE.md); test_airflow_enum_sync.py keeps the two in sync.

board'FL_DBPR' | 'CA_CSLB' | 'WA_LNI' | 'VA_DPOR' | 'OR_CCB' | 'AR_CLB' | 'MN_DLI' | 'TX_TDLR' | 'CT_DCP' | 'IL_IDFPR' | 'NY_DOL' | 'NYC_DOB' | 'NV_NSCB' | 'AZ_ROC' | 'NJ_DCA' | 'MA_OPSI' | 'TN_BLC' | 'TN_HIC' | 'MA_OCABR' | 'AL_GCB' | 'LA_LSLBC' | 'NC_LBGC' | 'NC_BEEC' | 'NC_PHFS' | 'OH_OCILB' | 'OH_SFM' | 'VT_DFS' | 'OK_CIB' | 'MS_BOC' | 'MS_BOC_RES' | 'WV_CLB' | 'CO_DORA' | 'NE_DOL' | 'PA_PHL' | 'TX_TSBPE' | 'MA_PLGF' | 'MA_ELEC' | 'MA_SMW' | 'PA_PGH' | 'NYC_DCWP' | 'OR_BCD' | 'MD_MCOCP' | 'MD_MCFRS' | 'OH_CLE' | 'CO_BOU' | 'DE_DPR' | 'IA_DIAL' | 'UT_DOPL' | 'WI_DSPS' | 'ND_SOS' | 'KY_HBC' | 'MD_MHIC' | 'MD_ELEC' | 'MD_HVACR' | 'MD_PLUMB' | 'DC_DLCP' required

The licensing body that issued a license; each value starts with its state's code.

A state can have several (New York's Labor Dept. and NYC's Buildings Dept.), so a license is identified by its number, state and board.

Attributes: FL_DBPR: Florida's Dept. of Business & Professional Regulation. CA_CSLB: California's Contractors State License Board. WA_LNI: Washington's Dept. of Labor & Industries. VA_DPOR: Virginia's Dept. of Professional & Occupational Regulation. OR_CCB: Oregon's Construction Contractors Board. AR_CLB: Arkansas's Contractors Licensing Board. MN_DLI: Minnesota's Dept. of Labor and Industry. TX_TDLR: Texas's Dept. of Licensing & Regulation. CT_DCP: Connecticut's Dept. of Consumer Protection. IL_IDFPR: Illinois's Dept. of Financial & Professional Regulation. NY_DOL: New York State's Dept. of Labor (public-work registry, mold and elevator contractors). NYC_DOB: New York City's Dept. of Buildings. NV_NSCB: Nevada's State Contractors Board. AZ_ROC: Arizona's Registrar of Contractors. NJ_DCA: New Jersey's Division of Consumer Affairs (home improvement, electrical, plumbing and HVACR boards). MA_OPSI: Massachusetts's Office of Public Safety and Inspections (construction supervisors and trade contractors). TN_BLC: Tennessee's Board for Licensing Contractors (contractor licenses). TN_HIC: Tennessee's Board for Licensing Contractors' home improvement licenses, numbered apart from its contractor licenses (301 numbers are on both on 2026-10-09). MA_OCABR: Massachusetts's Office of Consumer Affairs and Business Regulation (home improvement contractor registrations, through the MA Contractor Hub). AL_GCB: Alabama's Licensing Board for General Contractors (prime and subcontractor licenses). LA_LSLBC: Louisiana's Licensing Board for Contractors (commercial, residential, home improvement and mold remediation licenses). NC_LBGC: North Carolina's Licensing Board for General Contractors. NC_BEEC: North Carolina's State Board of Examiners of Electrical Contractors. NC_PHFS: North Carolina's State Board of Examiners of Plumbing, Heating and Fire Sprinkler Contractors. OH_OCILB: Ohio's Construction Industry Licensing Board (electrical, HVAC, plumbing, hydronics, refrigeration). OH_SFM: Ohio's State Fire Marshal (fire protection companies). VT_DFS: Vermont's Division of Fire Safety (master and special electricians and plumbers). OK_CIB: Oklahoma's Construction Industries Board (roofing contractor registrations). MS_BOC: Mississippi's State Board of Contractors, commercial program. MS_BOC_RES: Mississippi's State Board of Contractors, residential program (numbered apart from commercial). WV_CLB: West Virginia's Contractor Licensing Board. CO_DORA: Colorado's Dept. of Regulatory Agencies (its Electrical and Plumbing Boards). NE_DOL: Nebraska's Dept. of Labor (contractor registration). PA_PHL: Philadelphia's Dept. of Licenses and Inspections (a city; Pennsylvania has no statewide license). TX_TSBPE: Texas's State Board of Plumbing Examiners (responsible master plumbers). MA_PLGF: Massachusetts's Board of State Examiners of Plumbers and Gas Fitters. MA_ELEC: Massachusetts's Board of State Examiners of Electricians. MA_SMW: Massachusetts's Board of Examiners of Sheet Metal Workers. PA_PGH: Pittsburgh's Dept. of Permits, Licenses, and Inspections (a city, like PA_PHL). NYC_DCWP: New York City's Dept. of Consumer and Worker Protection (home improvement contractors). OR_BCD: Oregon's Building Codes Division (electrical, plumbing, boiler and elevator contractors). MD_MCOCP: Montgomery County, Maryland's Office of Consumer Protection (new home builders; a county). MD_MCFRS: Montgomery County, Maryland's Fire and Rescue Service (fire alarm system licenses; a county). OH_CLE: Cleveland's Dept. of Building & Housing (contractor registrations; a city). CO_BOU: The City of Boulder's Planning & Development Services (contractor licenses; a city). DE_DPR: Delaware's Division of Professional Regulation (master electricians, plumbers and HVACR). IA_DIAL: Iowa's Dept. of Inspections, Appeals, and Licensing (construction contractor registrations). UT_DOPL: Utah's Division of Professional Licensing (its opt-in Construction Business Registry). WI_DSPS: Wisconsin's Dept. of Safety and Professional Services (contractors and master plumbers). ND_SOS: North Dakota's Secretary of State (contractor licenses, Classes A-D). KY_HBC: Kentucky's Dept. of Housing, Buildings and Construction (electrical, HVAC, plumbing, fire protection). MD_MHIC: Maryland's Home Improvement Commission. MD_ELEC: Maryland's State Board of Master Electricians. MD_HVACR: Maryland's State Board of HVACR Contractors. MD_PLUMB: Maryland's State Board of Plumbing. DC_DLCP: The District of Columbia's Dept. of Licensing and Consumer Protection (contractor business licenses).

status'active' | 'inactive' | 'probation' | 'expired' | 'suspended' | 'revoked' required

Current status of a contractor license, as reported by its state board.

issue_datestring date nullable required

Date the license was originally issued.

expiration_datestring date nullable required

Date the license expires or expired.

bond_numberstring nullable required

Surety bond number backing this license, if applicable.

bond_amountnumber nullable required

Surety bond amount in USD, if applicable.

addressstring nullable required

Registered business or contractor address on file with the state board.

phonestring nullable required

Business phone as 10 NANP digits with no formatting, or null when the board reports none (or only a placeholder).

state_business_idstring nullable required

The issuing state's own business-registration id (e.g. Washington's UBI). Only comparable between licenses from the same state.

principal_namestring nullable required

The owner/principal of record, in the board's own name format.

last_verified_atstring date-time nullable required

When this license was last confirmed against the state board's live record.

delisted_atstring date-time nullable required

When this license disappeared from the state board's full listing, or null while the board still lists it. When set, status is the last value the board reported and may be stale.

entity_type'sole_proprietor' | 'llc' | 'corporation' | 'partnership' | 'limited_partnership' | 'llp' | 'joint_venture' | 'association' | 'trust'

The legal form of the licensed business, as the board records it.

Attributes: SOLE_PROPRIETOR: One person trading in their own name (CA "Sole Owner", WA "Individual"). LLC: A limited liability company. CORPORATION: A corporation. PARTNERSHIP: A general partnership. LIMITED_PARTNERSHIP: A limited partnership. LLP: A limited liability partnership. JOINT_VENTURE: A joint venture of two or more businesses. ASSOCIATION: An association. TRUST: A trust.

created_atstring date-time required

When this license record was first ingested.

Changes

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