Errors - LicenseSearcher

Errors use HTTP status codes and a JSON body:

{
  "error": {
    "type": "validation_error",
    "message": "The county query parameter is required for Hawaii (HI)."
  }
}

County errors

Condition	Response
Missing, blank, repeated, or unrecognized county in Hawaii or Nevada	`400 validation_error`
Hawaii: `county=hawaii` or `county=kauai`	`400 county_not_supported`
Valid county with no matching license	`404 license_not_found` on lookup; `200` with `data: []` on search

Nevada accepts recognized counties outside its coverage; these return no records. Hawaii rejects its two unsupported counties. See County queries.

State discovery errors

The public state endpoints do not require an API key or state entitlement and do not create billable request logs. These rules apply to both endpoints, including errors.

Request or condition	Response
`/v2/state/california`, `/v2/state/c`, or `/v2/state/12`	`400 validation_error`: provide a two-letter state code.
`/v2/state/zz` (well-formed but outside the 50 states and DC)	`404 state_not_found`.
Known unsupported state	`200` metadata with `support: "unsupported"` and `statuses: []`.
Database failure or missing/inconsistent reference configuration	`500 api_error`; never a successful empty list or an unsupported classification.

{
  "error": {
    "type": "state_not_found",
    "message": "State not found."
  }
}

HTTP status codes

Code	Status	Meaning
`200`	OK	Request succeeded.
`400`	Bad Request	The request is invalid: a required parameter is missing or invalid (`validation_error`), or the requested county is unsupported (`county_not_supported`).
`401`	Unauthorized	No valid API key was provided.
`403`	Forbidden	Your API key does not have permission to access this resource (for example, a state it isn’t scoped to).
`404`	Not Found	The requested resource does not exist, or license lookup/search targets an unsupported state. Discovery uses `state_not_found` for codes outside the 50 states and DC.
`429`	Too Many Requests	Rate limit exceeded. Retry later.
`500`–`504`	Server Errors	Server error.

Authenticated license lookup and search requests that return a 4xx status code are billed to your account. Public state requests are not billed. See Authentication for details.