> ## Documentation Index
> Fetch the complete documentation index at: https://docs.licensesearcher.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The License Object

> Every field returned for a liquor license.

Both the [Retrieve a License](/liquor-licenses/retrieve-a-license) and [Search](/liquor-licenses/search) endpoints return license objects in the same shape. LicenseSearcher normalizes data from every source into this one schema.

## Attributes

<ResponseField name="license" type="string">
  The liquor license or permit number issued by the government authority. Leading zeros are included.
</ResponseField>

<ResponseField name="object" type="string">
  String representing the object's type. The value is always `license`.
</ResponseField>

<ResponseField name="address" type="hash">
  The registered address for the `business` or `owner`.

  <Expandable title="address properties">
    <ResponseField name="line_1" type="string">
      Address line 1 (street or PO Box).
    </ResponseField>

    <ResponseField name="line_2" type="string">
      Address line 2 (suite number, and similar).
    </ResponseField>

    <ResponseField name="city" type="string">
      City, suburb, or town.
    </ResponseField>

    <ResponseField name="county" type="string">
      County or county equivalent.
    </ResponseField>

    <ResponseField name="state" type="string">
      The US state for the address.
    </ResponseField>

    <ResponseField name="zip" type="string">
      The ZIP code for the address.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="business" type="string">
  The business name for the license holder. This is not necessarily the legal registered name — it can be a DBA name.
</ResponseField>

<ResponseField name="dates" type="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.

  <Expandable title="common date fields">
    <ResponseField name="effective" type="date">
      The date the license becomes effective.
    </ResponseField>

    <ResponseField name="expires" type="date">
      The date the license expires.
    </ResponseField>

    <ResponseField name="issued" type="date">
      The date the license was issued.
    </ResponseField>

    <ResponseField name="issued_original" type="date">
      The date the license was originally issued.
    </ResponseField>

    <ResponseField name="issued_latest" type="date">
      The date the license was most recently renewed.
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Not every state reports dates. For example, Michigan (`mi`) currently returns no dates — use `status` to check a license's validity there.
</Note>

<ResponseField name="details" type="hash">
  Additional license information, if available. `null` if no additional information was found.

  <Expandable title="details properties">
    <ResponseField name="class" type="string">
      A class code that describes the license.
    </ResponseField>

    <ResponseField name="description" type="string">
      A description of the license.
    </ResponseField>

    <ResponseField name="type" type="string">
      The type of license.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="owner" type="string">
  The legal registered name on record for the business and license holder.
</ResponseField>

<ResponseField name="phone" type="string">
  The phone number for the business or owner.
</ResponseField>

<ResponseField name="state" type="string">
  The two-digit USPS state code the license is registered in. See [Supported States](/supported-states).
</ResponseField>

<ResponseField name="status" type="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.

  <Expandable title="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` |
  </Expandable>
</ResponseField>

<ResponseField name="updated_at" type="timestamp">
  The timestamp when LicenseSearcher last fetched the license's data.
</ResponseField>

## Example object

```json The license object theme={null}
{
  "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"
}
```