Quickstart

You need an API key with access to the state you want to query.

Prerequisites

You will need:

A LicenseSearcher account. Create one or talk to sales.
An API key scoped to at least one supported state.
cURL or another HTTP client.

Get started

Get your API key

Sign in to your Dashboard and create an API key. Keys are scoped to specific states — make sure your account is subscribed to the states you want to query.

Keep your key out of client-side code and public repositories. Authenticated requests are billed, including 4xx responses.

Authenticate your request

Pass your key as a bearer token in the Authorization header on every license lookup or search request. All calls must be made over HTTPS.

Authorization: Bearer YOUR_API_KEY

Make your first request

Search for a license by business name in a state your key is scoped to. This example searches New York for “bernardin”:

curl "https://api.licensesearcher.com/v2/search?state=ny&name=bernardin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Api-Version: 2026-11-01"

const res = await fetch(
  "https://api.licensesearcher.com/v2/search?state=ny&name=bernardin",
  { headers: { Authorization: "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01" } }
);
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.licensesearcher.com/v2/search",
    params={"state": "ny", "name": "bernardin"},
    headers={"Authorization": "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01"},
)
print(res.json())

Hawaii and Nevada require a county parameter. See County queries for accepted values.

Read the response

A successful search returns an array of up to 10 license objects:

{
  "data": [
    {
      "license": "1026288",
      "object": "license",
      "address": {
        "city": "NEW YORK",
        "county": "NEW YORK",
        "line_1": "787 7TH AVENUE",
        "line_2": "THE EQUITABLE TOWER CENTER",
        "state": "NY",
        "zip": "10019"
      },
      "business": "LE BERNARDIN",
      "owner": "LE BERNARDIN INC",
      "phone": null,
      "state": "ny",
      "types": [
        {
          "agency": {
            "id": "e21e87eb-9572-536f-8913-0ddbec6399ec",
            "object": "agency",
            "name": "New York State Liquor Authority",
            "url": "https://sla.ny.gov/"
          },
          "class": null,
          "delisted": false,
          "description": null,
          "details": {
            "effective": "2023-01-01"
          },
          "expires": "2024-12-31",
          "issued": "2022-11-29",
          "status": "active",
          "type": "OP",
          "updated_at": "2023-10-31 21:41:50.555399"
        }
      ]
    }
  ]
}

Already have a license number? Retrieve it directly with Retrieve a license.

Authentication: API keys, state access, and billing.
Search licenses: parameters and response examples.
License object: response fields.
Supported states: current coverage.

Get started

Liquor Licenses

States

Prerequisites

Get started

​Prerequisites

​Get started

​Related reference

Prerequisites

Get started

Related reference