Plumbline - Contractor License Checks

Check a contractor's license against official state and local licensing records covering dozens of US jurisdictions. The covered set grows over time; GET /v1/coverage on this host for the exact current list, and never assume from this description whether a jurisdiction is covered. Provide a license number or a business name, plus the jurisdiction. Returns match (the license record with status and provenance), candidates (disambiguate and call again; page with offset), no_match_in_index (NOT a determination of unlicensure), or jurisdiction_not_covered (with an official pointer URL for that jurisdiction; the response message states exactly what the link is, which for some jurisdictions is a consumer-protection or licensing-board page rather than a license lookup, so relay the message's wording and never present the link as a license lookup unless the message says it is one).

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Business name, e.g. "Bayside Plumbing"'}, 'offset': {'type': 'integer', 'description': 'Pagination offset into the candidates list, default 0. Use with total_candidates from a prior call to page through large candidate sets.'}, 'license': {'type': 'string', 'description': 'License number, e.g. "1000002"'}, 'jurisdiction': {'type': 'string', 'description': 'State or local jurisdiction code, e.g. "CA" ("US-CA" style also accepted) or "NYC". Coverage spans dozens of US jurisdictions; GET /v1/coverage for the exact current list.'}}}