The License Object

Both the Retrieve a License and Search endpoints return license objects in the same shape. LicenseSearcher normalizes data from every source into this one schema. The shape depends on your API version. The attributes below describe the default version (2026-07-01). For the multi-type shape, see Version 2026-08-01.

Attributes

string

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

string

String representing the object’s type. The value is always license.

hash

The registered address for the business or owner.

Show address properties

string

Address line 1 (street or PO Box).

string

Address line 2 (suite number, and similar).

string

City, suburb, or town.

string

County or county equivalent.

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.

hash

Date information, keyed by two-letter state code. Within each state key are the date fields that state commonly reports. Field availability varies by state.

Show common date fields

date

The date the license becomes effective.

date

The date the license expires.

date

The date the license was issued.

date

The date the license was originally issued.

date

The date the license was most recently renewed.

Not every state reports dates. For example, Michigan (mi) currently returns no dates — use status to check a license’s validity there.

boolean

true when the license has dropped out of the state’s published data — the state no longer tracks it, and the record stops receiving updates.

hash

Additional license information, if available. null if no additional information was found.

Show details properties

string

A class code that describes the license.

string

A description of the license.

string

The type of license.

string

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

string

The phone number for the business or owner.

string

The two-digit USPS state code the license is registered in. See Supported States.

enum

The license’s current status, as defined by the state’s licensing agency. LicenseSearcher does not transform statuses into its own values — you receive the state’s raw status. Possible values vary by state and are subject to change.

Show status values by state

State	Possible values
AZ — Arizona	`active`, `cancelled`, `expired`, `inactive`, `not approved`, `pending`, `revoked`
CA — California	`active`, `pend`, `r64b`, `revpen`, `slmshd`, `surend`, `suspen`
CO — Colorado	`active`, `expired`, `pending`, `surrendered`
FL — Florida	`20`, `21`, `41`, `42`, `45`
IL — Illinois	`active`, `expired`, `revoked`
MI — Michigan	`active`, `conditional`, `escrow`
MN — Minnesota	`approved`, `canceled`, `denied`, `expired`, `revoked`
NY — New York	`active`, `ative temporary`, `inactive`, `pending`
TN — Tennessee	`about to expire`, `active`
TX — Texas	`active`, `active - renewal pending`, `cancelled`, `expired`, `expired - original required`, `surrendered`, `suspended`, `suspended - renewal pending`, `temporarily surrendered`, `temporarily surrendered - renewal pending`

timestamp

The timestamp when LicenseSearcher last fetched the license’s data.

Example object

The license object

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

Version 2026-08-01: multi-type licenses

A license number can carry several license types at once — for example, a California premises holding an on-sale license and a caterer’s permit under one file number, each with its own status and expiration date. Send X-Api-Version: 2026-08-01 and the license object represents every type the number holds. In this shape, the parent object keeps only premises-level identity — license, object, address, business, owner, phone, state — and everything that varies per type, including updated_at, lives in the types array.

Parent attributes

license, object, address, business, owner, and phone are unchanged from the default version. The parent has no status, dates, details, delisted, or updated_at — read them from each entry in types.

array

One entry per license type the number holds, ordered with active types before delisted ones, then by ascending type code. Every entry has the same keys in every state — a field the state doesn’t publish is null, so your parser never branches on state.

Show type entry attributes

string

The license type code, as issued by the state.

string

A class code that describes the license.

string

A description of the license.

enum

The current status for this type, as defined by the state’s licensing agency. Same raw state values as the default version’s status.

boolean

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

date

The date this license type was originally issued. This field always means original issuance in every state.

date

The date this license type expires.

timestamp

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

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.

enum

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

A details field that turns out to be published by every state gets promoted to a core entry field in a future dated version — never moved silently within an existing version.

Example object (2026-08-01)

The license object

{
  "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"
    },
    {
      "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 API

Attributes

Example object

Version 2026-08-01: multi-type licenses

Parent attributes

Example object (2026-08-01)

​Attributes

​Example object

​Version 2026-08-01: multi-type licenses

​Parent attributes

​Example object (2026-08-01)

Attributes

Example object

Version 2026-08-01: multi-type licenses

Parent attributes

Example object (2026-08-01)