Retrieve a License

curl "https://api.licensesearcher.com/v2/license/ny/1026288" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.licensesearcher.com/v2/license/ca/00000004" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Api-Version: 2026-08-01"

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ny/1026288",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.licensesearcher.com/v2/license/ny/1026288",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
res.raise_for_status()
print(res.json())

{
  "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",
    "dates": {
      "ny": {
        "effective": "2023-01-01",
        "expires": "2024-12-31",
        "issued_latest": null,
        "issued_original": "2022-11-29"
      }
    },
    "details": {
      "class": null,
      "description": null,
      "type": "OP"
    },
    "owner": "LE BERNARDIN INC",
    "phone": null,
    "state": "ny",
    "status": "active",
    "updated_at": "2023-10-31 21:41:50.555399"
  }
}

{
  "data": {
    "license": "00000004",
    "object": "license",
    "address": {
      "city": "SOUTH SAN FRANCISCO",
      "county": "SAN MATEO",
      "line_1": "272 S MAPLE AVE",
      "line_2": null,
      "state": "CA",
      "zip": "94080"
    },
    "business": null,
    "owner": "PELLEGRINI BROS WINES INC",
    "phone": null,
    "state": "ca",
    "types": [
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-06-30",
        "issued": "1978-03-01",
        "status": "active",
        "type": "02",
        "updated_at": "2026-07-30 02:45:22.174991"
      },
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-02-28",
        "issued": "1978-03-01",
        "status": "active",
        "type": "17",
        "updated_at": "2026-07-30 02:45:22.174991"
      }
    ]
  }
}

curl "https://api.licensesearcher.com/v2/license/ny/1026288" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.licensesearcher.com/v2/license/ca/00000004" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Api-Version: 2026-08-01"

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ny/1026288",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.licensesearcher.com/v2/license/ny/1026288",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
res.raise_for_status()
print(res.json())

{
  "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",
    "dates": {
      "ny": {
        "effective": "2023-01-01",
        "expires": "2024-12-31",
        "issued_latest": null,
        "issued_original": "2022-11-29"
      }
    },
    "details": {
      "class": null,
      "description": null,
      "type": "OP"
    },
    "owner": "LE BERNARDIN INC",
    "phone": null,
    "state": "ny",
    "status": "active",
    "updated_at": "2023-10-31 21:41:50.555399"
  }
}

{
  "data": {
    "license": "00000004",
    "object": "license",
    "address": {
      "city": "SOUTH SAN FRANCISCO",
      "county": "SAN MATEO",
      "line_1": "272 S MAPLE AVE",
      "line_2": null,
      "state": "CA",
      "zip": "94080"
    },
    "business": null,
    "owner": "PELLEGRINI BROS WINES INC",
    "phone": null,
    "state": "ca",
    "types": [
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-06-30",
        "issued": "1978-03-01",
        "status": "active",
        "type": "02",
        "updated_at": "2026-07-30 02:45:22.174991"
      },
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-02-28",
        "issued": "1978-03-01",
        "status": "active",
        "type": "17",
        "updated_at": "2026-07-30 02:45:22.174991"
      }
    ]
  }
}

Retrieve a single liquor license by its state and exact license number.

GET /v2/license/:state/:license

Path parameters

string

required

The two-digit USPS state code (for example, ny). Must be a supported state your key is scoped to. Unsupported states return a 404.

string

required

The liquor license or permit number issued by the government authority. Must be an exact match and must include any leading zeros.

Headers

string

Pins the API version. Send 2026-08-01 for the multi-type shape, where the license object carries a types array — one entry per license type the number holds. Omit for the default version. A malformed value returns a 400.

Returns

Returns a license object if the call succeeds and a matching license is found. Returns null if the call succeeds but no license is found. With X-Api-Version: 2026-08-01, the object contains every license type the number holds; the default version returns a single record built from the primary type (active before delisted, lowest type code first).

curl "https://api.licensesearcher.com/v2/license/ny/1026288" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.licensesearcher.com/v2/license/ca/00000004" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Api-Version: 2026-08-01"

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ny/1026288",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.licensesearcher.com/v2/license/ny/1026288",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
res.raise_for_status()
print(res.json())

{
  "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",
    "dates": {
      "ny": {
        "effective": "2023-01-01",
        "expires": "2024-12-31",
        "issued_latest": null,
        "issued_original": "2022-11-29"
      }
    },
    "details": {
      "class": null,
      "description": null,
      "type": "OP"
    },
    "owner": "LE BERNARDIN INC",
    "phone": null,
    "state": "ny",
    "status": "active",
    "updated_at": "2023-10-31 21:41:50.555399"
  }
}

{
  "data": {
    "license": "00000004",
    "object": "license",
    "address": {
      "city": "SOUTH SAN FRANCISCO",
      "county": "SAN MATEO",
      "line_1": "272 S MAPLE AVE",
      "line_2": null,
      "state": "CA",
      "zip": "94080"
    },
    "business": null,
    "owner": "PELLEGRINI BROS WINES INC",
    "phone": null,
    "state": "ca",
    "types": [
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-06-30",
        "issued": "1978-03-01",
        "status": "active",
        "type": "02",
        "updated_at": "2026-07-30 02:45:22.174991"
      },
      {
        "class": null,
        "delisted": false,
        "description": null,
        "details": { "lic_or_app": "LIC" },
        "expires": "2027-02-28",
        "issued": "1978-03-01",
        "status": "active",
        "type": "17",
        "updated_at": "2026-07-30 02:45:22.174991"
      }
    ]
  }
}

Get started

Liquor Licenses API

Path parameters

Headers

Returns

​Path parameters

​Headers

​Returns

Path parameters

Headers

Returns