> ## 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.

# Retrieve a state

Retrieve a state's licensing agencies, statuses, and coverage. No API key is required; requests are not billed.

```bash theme={null}
GET /v2/state/:state
```

## Path parameters

**state** `string` *required*

Two-letter state or DC code, case-insensitive. Use [List states](https://docs.licensesearcher.com/states/list-states.md) for valid codes.

## Returns

Returns a [state object](https://docs.licensesearcher.com/states/state-object.md) in `data`. Known unsupported states return `200` with `support: "unsupported"` and `statuses: []`.

```bash cURL theme={null}
curl "https://api.licensesearcher.com/v2/state/ca"
```

```javascript JavaScript theme={null}
const res = await fetch("https://api.licensesearcher.com/v2/state/ca");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
```

```python Python theme={null}
import requests

res = requests.get("https://api.licensesearcher.com/v2/state/ca")
res.raise_for_status()
print(res.json())
```

```json Response theme={null}
{
  "data": {
    "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"
  }
}
```

## Errors

Invalid code formats return `400 validation_error`. Unknown two-letter codes return `404 state_not_found`. Database or reference data failures return `500 api_error`. See [Errors](https://docs.licensesearcher.com/errors.md#state-discovery-errors).


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