The State object

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

Attributes

string

Lowercase two-letter state or DC code.

string

Always state.

object[]

Licensing agencies, sorted by ID.

Show agencies properties

string

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

string

Always agency.

string

state, district, county, or municipal.

string

Name of the jurisdiction the agency serves.

string

Agency name.

string

Agency website.

object

Source availability and API support by record type.

Show capabilities properties

object

Availability of individual alcohol server certification records.

Show alcohol_server_certifications properties

boolean | null

Whether the source provides these records. null means unknown.

object[]

Certification programs.

Show programs properties

string

Stable program identifier.

string | null

Issuing agency ID, if known.

string

Program name.

string

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

string | null

Program website.

string

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

object

Availability of delinquency records.

Show delinquency_records properties

boolean | null

Whether the source provides these records. null means unknown.

string

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

object

Geographic coverage of the license data.

Show coverage properties

string[]

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

string | null

Coverage limitations, if any.

boolean | null

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

object

How licensing authority is organized.

Show jurisdiction properties

string[]

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

boolean | null

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

string

State or district name.

object

Parameters required for license lookup and search.

Show query_requirements properties

boolean

Whether license requests require a county parameter. See County queries.

string[]

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

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.

string

License data coverage: supported, partially_supported, or unsupported.

Example

Response

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

Get started

Liquor Licenses

States

Attributes

Example

​Attributes

​Example

Attributes

Example