Skip to main content
The API uses /v2 paths. Dated response changes use the X-Api-Version header.
Released to production on November 4, 2026: the state endpoints and November license responses are live at https://api.licensesearcher.com, including status: "delisted" for types with delisted: true; no version header is required.

November 2026 changes

The 2026-11-01 response includes:
  • Each license type includes agency: an object with id, object, name, and url, or null if the issuer is unknown.
  • Non-null address fields are uppercase.
  • A type with delisted: true has status: "delisted". Other statuses keep their lowercase source value.
The existing types array is unchanged. These rules apply to both lookup and search.

Release schedule

The response changes automatically on November 1, 2026 at 00:00 UTC: The previous response omits agency, keeps source address casing, and returns the source status even when a type is delisted. Header names are case-insensitive. Only 2026-11-01 opts in early. Unknown, old, blank, or repeated values use the default for the request time. An old header cannot retain the previous response after the cutoff. License responses set Vary: X-Api-Version and Cache-Control: private, no-store.

Update your client

Test lookup and search with the header. Allow types[].agency to be null, preserve null address values, and accept delisted as a status. Before the cutoff, omit the header to compare responses.

State endpoints

List states and Retrieve a state do not use the version header.

County parameters

Hawaii and Nevada require county on lookup and search. Add it to existing callers and include the issuing county in stored Hawaii license identities. See County queries for accepted values and differences in error handling.