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": {
    "jurisdiction": {
      "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.",
      "type": "string"
    },
    "license": {
      "description": "License number, e.g. \"1000002\"",
      "type": "string"
    },
    "name": {
      "description": "Business name, e.g. \"Bayside Plumbing\"",
      "type": "string"
    },
    "offset": {
      "description": "Pagination offset into the candidates list, default 0. Use with total_candidates from a prior call to page through large candidate sets.",
      "type": "integer"
    }
  }
}