The License Object - LicenseSearcher

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.

Attributes

license

string

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

object

string

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

address

hash

The registered address for the business or owner.

Show address properties

line_1

string

Address line 1 (street or PO Box).

line_2

string

Address line 2 (suite number, and similar).

city

string

City, suburb, or town.

county

string

County or county equivalent.

state

string

The US state for the address.

zip

string

The ZIP code for the address.

business

string

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

dates

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

effective

date

The date the license becomes effective.

expires

date

The date the license expires.

issued

date

The date the license was issued.

issued_original

date

The date the license was originally issued.

issued_latest

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.

details

hash

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

Show details properties

class

string

A class code that describes the license.

description

string

A description of the license.

type

string

The type of license.

owner

string

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

phone

string

The phone number for the business or owner.

state

string

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

status

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`

updated_at

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

​Attributes

​Example object

Attributes

Example object