Retrieve a license

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

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ca/00000004",
  { headers: { Authorization: "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01" } }
);
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/ca/00000004",
    headers={"Authorization": "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01"},
)
res.raise_for_status()
print(res.json())

{
  "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"
      }
    ]
  }
}

{
  "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": [
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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"
      },
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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/ca/00000004" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Api-Version: 2026-11-01"

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ca/00000004",
  { headers: { Authorization: "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01" } }
);
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/ca/00000004",
    headers={"Authorization": "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01"},
)
res.raise_for_status()
print(res.json())

{
  "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"
      }
    ]
  }
}

{
  "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": [
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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"
      },
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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-letter 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.

Optional response version header

string

Set 2026-11-01 to use the response shown below before November 1, 2026 at 00:00 UTC. After that, it is the default. See API compatibility.

Query parameters

string

Required for Hawaii and Nevada. Use honolulu or maui for Hawaii, or clark for covered Nevada records. Pass exactly one value. See County queries for coverage, accepted names, and errors.

Returns

Returns a license object if a matching license is found. The object contains every license type the number holds within the requested jurisdiction. For Hawaii, all types belong to the requested county; retain (state, address.county, license) as the license identity. Returns a 404 license_not_found error if no matching license exists.

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

const res = await fetch(
  "https://api.licensesearcher.com/v2/license/ca/00000004",
  { headers: { Authorization: "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01" } }
);
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/ca/00000004",
    headers={"Authorization": "Bearer YOUR_API_KEY", "X-Api-Version": "2026-11-01"},
)
res.raise_for_status()
print(res.json())

{
  "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"
      }
    ]
  }
}

{
  "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": [
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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"
      },
      {
        "agency": {
          "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "object": "agency",
          "name": "California Department of Alcoholic Beverage Control",
          "url": "https://www.abc.ca.gov/"
        },
        "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

States

Path parameters

Optional response version header

Query parameters

Returns

​Path parameters

​Optional response version header

​Query parameters

​Returns

Path parameters

Optional response version header

Query parameters

Returns