Contractor Licence Changes

Has this contractor's licence changed? Returns every status transition observed in the state board's own published file since 2026-07-17 -- suspensions, expirations, reinstatements and first appearance -- with the date each was seen. This is change over time, not a current-status lookup: use it after a snapshot check, to find out whether the licence you are about to rely on lapsed and came back. Distinguishes 'no change observed' from 'this source is not observed for that change', which are not the same answer. Only public, unsuppressed directory records are returned. Read-only.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "patternMessage": "argument state must be a two-letter state code, e.g. CA",
      "description": "Two-letter state code. Covered: AZ, CA, CO, CT, DE, FL, IA, NV, NY, OR, TX, UT, VA, WA"
    },
    "license_number": {
      "type": "string",
      "pattern": ".*\\S.*",
      "patternMessage": "argument license_number must not be blank",
      "description": "The licence number as the board prints it"
    }
  },
  "required": [
    "state",
    "license_number"
  ]
}

What changed lately across a state: licences that lapsed, were reinstated, or appeared for the first time, newest first, optionally narrowed to one trade. Answers the monitoring question a single lookup cannot -- which contractors lost standing this month, or who is newly licensed in this trade. Read-only.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "patternMessage": "argument state must be a two-letter state code, e.g. CA",
      "description": "Two-letter state code. Covered: AZ, CA, CO, CT, DE, FL, IA, NV, NY, OR, TX, UT, VA, WA"
    },
    "change_type": {
      "type": "string",
      "enum": [
        "lapse",
        "reinstate",
        "status_change",
        "new_license"
      ],
      "description": "lapse = active to suspended/expired/inactive; new_license = first observed"
    },
    "days": {
      "type": "integer",
      "description": "Look back 1 to 365 days (default 30)"
    },
    "trade": {
      "type": "string",
      "description": "Optional trade filter, e.g. electricians, plumbers"
    },
    "limit": {
      "type": "integer",
      "description": "Max rows, clamped to 1 through 100 (default 25)"
    }
  },
  "required": [
    "state"
  ]
}