> ## 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 State object

A state's licensing agencies, data coverage, query requirements, and source status values.

## Attributes

**id** `string`

Lowercase two-letter state or DC code.

**object** `string`

Always `state`.

**agencies** `object[]`

Licensing agencies, sorted by ID.

**agencies properties**

**id** `string`

Stable agency ID. Matches `types[].agency.id` in license responses.

**object** `string`

Always `agency`.

**jurisdiction\_level** `string`

`state`, `district`, `county`, or `municipal`.

**jurisdiction\_name** `string`

Name of the jurisdiction the agency serves.

**name** `string`

Agency name.

**website** `string`

Agency website.

**capabilities** `object`

Source availability and API support by record type.

**capabilities properties**

**alcohol\_server\_certifications** `object`

Availability of individual alcohol server certification records.

**alcohol\_server\_certifications properties**

**available\_from\_source** `boolean | null`

Whether the source provides these records. `null` means unknown.

**programs** `object[]`

Certification programs.

**programs properties**

**id** `string`

Stable program identifier.

**agency\_id** `string | null`

Issuing agency ID, if known.

**name** `string`

Program name.

**support** `string`

`supported`, `partially_supported`, `unsupported`, or `unknown` for records available through the API.

**website** `string | null`

Program website.

**support** `string`

`supported`, `partially_supported`, `unsupported`, or `unknown` for records available through the API.

**delinquency\_records** `object`

Availability of delinquency records.

**delinquency\_records properties**

**available\_from\_source** `boolean | null`

Whether the source provides these records. `null` means unknown.

**support** `string`

`supported`, `partially_supported`, `unsupported`, or `unknown` for records available through the API.

**coverage** `object`

Geographic coverage of the license data.

**coverage properties**

**counties** `string[]`

Covered county names in lowercase. Empty for statewide or unknown coverage.

**notes** `string | null`

Coverage limitations, if any.

**statewide** `boolean | null`

Whether the data covers the whole state. `null` means unknown.

**jurisdiction** `object`

How licensing authority is organized.

**jurisdiction properties**

**levels** `string[]`

Authority levels: `state`, `district`, `county`, or `municipal`. Empty if unknown.

**statewide** `boolean | null`

Whether licensing uses statewide authority. `null` means unknown. For DC, this means district-wide.

**name** `string`

State or district name.

**query\_requirements** `object`

Parameters required for license lookup and search.

**query\_requirements properties**

**county\_required** `boolean`

Whether license requests require a `county` parameter. See [County queries](https://docs.licensesearcher.com/liquor-licenses/county-queries.md).

**covered\_counties** `string[]`

Covered counties in lowercase. Other recognized counties may be accepted as filters without having data.

**statuses** `string[]`

Distinct lowercase source statuses in queryable records, sorted alphabetically. Includes retained delisted records; excludes deleted records, nulls, and blank values. Nonblank source whitespace is preserved. These are source values, so they can differ from the `delisted` status returned by license endpoints.

**support** `string`

License data coverage: `supported`, `partially_supported`, or `unsupported`.

## Example

```json Response theme={null}
{
  "id": "ca",
  "object": "state",
  "agencies": [
    {
      "id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
      "object": "agency",
      "jurisdiction_level": "state",
      "jurisdiction_name": "California",
      "name": "California Department of Alcoholic Beverage Control",
      "website": "https://www.abc.ca.gov/"
    }
  ],
  "capabilities": {
    "alcohol_server_certifications": {
      "available_from_source": true,
      "programs": [
        {
          "id": "ca_rbs",
          "agency_id": "d736effe-a79a-5a78-b7bf-0dea0e72f264",
          "name": "Responsible Beverage Service (RBS)",
          "support": "unsupported",
          "website": "https://www.abc.ca.gov/education/rbs/"
        }
      ],
      "support": "unsupported"
    },
    "delinquency_records": {
      "available_from_source": null,
      "support": "unsupported"
    }
  },
  "coverage": {
    "counties": [],
    "notes": null,
    "statewide": true
  },
  "jurisdiction": {
    "levels": [
      "state"
    ],
    "statewide": true
  },
  "name": "California",
  "query_requirements": {
    "county_required": false,
    "covered_counties": []
  },
  "statuses": [
    "active",
    "pend",
    "r64b",
    "revpen",
    "slmshd",
    "surend",
    "suspen"
  ],
  "support": "supported"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.