License object

Lookup returns one license object; search returns an array of them. The address and business fields describe the premises. Each entry in types has its own status, dates, and issuing agency. Hawaii license numbers can repeat across counties. Store (state, address.county, license) to distinguish them. In Nevada, the county describes coverage; types[].agency identifies the issuer. See County queries.

Attributes

string

The liquor license or permit number issued by the government authority. Leading zeros are included.

string

Always license.

hash

The registered address for the business or owner. Every non-null address field is uppercase, including city, county, address lines, state, and ZIP/postal code. Missing values remain null; the top-level state code remains lowercase.

Show address properties

string

City, suburb, or town.

string

County or county equivalent.

string

Address line 1 (street or PO Box).

string

Address line 2 (suite number, and similar).

string

The US state for the address.

string

The ZIP code for the address.

string

The business name for the license holder. This is not necessarily the legal registered name — it can be a DBA name.

string

The legal registered name on record for the business and license holder.

string

The phone number for the business or owner.

string

The lowercase two-letter USPS state code the license is registered in. See Supported states.

array

One entry per license type the number holds, ordered with non-delisted types before delisted ones, then by ascending type code. Fields the source does not publish are null.

Show type entry attributes

object | null

Issuing agency for this license type. null if unknown.

Show agency properties

string

Stable agency ID. Matches agencies[].id in the state response.

string

Always agency.

string

Agency name.

string

Agency website.

string

License class code from the source.

boolean

true when this type has dropped out of the state’s published data and stops receiving updates.

string

License type description from the source.

hash

State-specific fields, under each state’s own vocabulary, present only where the state publishes them. null when the state publishes none.

Show details properties

date

The date the current status took effect, where the state publishes it.

date

The most recent issuance or renewal date, where the state publishes it. Distinct from the core issued, which is always the original issuance.

string

California only. LIC for an issued license, APP for a pending application — the record kind as ABC publishes it.

date

Expiration date for this type.

date

Original issuance date for this license type.

string

When delisted is true, status is always delisted. Otherwise, this is the current status for this type, as defined by the state’s licensing agency. LicenseSearcher lowercases the value but does not map it to a shared status vocabulary. Possible values vary by state and can change. See state status values for values observed in queryable records.

string

The license type identifier. Hawaii identifiers include the issuing county, such as MAUI:PERMANENT; the original government-issued license number remains in license.

timestamp

The timestamp when LicenseSearcher last fetched this type’s data.

License objects begin with license, then object. Nested entities begin with id, then object. Remaining keys sort alphabetically at every depth, including objects inside arrays; arrays retain their element order.

Example

Response

{
  "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"
    },
    {
      "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": "18",
      "updated_at": "2026-07-30 02:45:22.174991"
    }
  ]
}

Get started

Liquor Licenses

States

Attributes

Example

​Attributes

​Example

Attributes

Example