/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
The2026-11-01 response includes:
- Each license type includes
agency: an object withid,object,name, andurl, ornullif the issuer is unknown. - Non-null address fields are uppercase.
- A type with
delisted: truehasstatus: "delisted". Other statuses keep their lowercase source value.
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. Allowtypes[].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 requirecounty 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.