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

# List states

List states by license data availability. No API key is required; requests are not billed.

```bash theme={null}
GET /v2/states
```

## Returns

Returns three arrays without a `data` wrapper. Together they contain all 50 states and DC. Codes are lowercase, unique, and sorted alphabetically. The example abbreviates the arrays with `...`.

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

```javascript JavaScript theme={null}
const res = await fetch("https://api.licensesearcher.com/v2/states");
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/states")
res.raise_for_status()
print(res.json())
```

```jsonc Response theme={null}
{
  "partially_supported": ["hi", "nv"],
  "supported": ["ar", "az", "ca", ...],
  "unsupported": ["ak", "al", "dc", ...]
}
```

## Attributes

**partially\_supported** `string[]`

States with data for part of the state.

**supported** `string[]`

States with statewide data.

**unsupported** `string[]`

States without license data.

Use [Retrieve a state](https://docs.licensesearcher.com/states/retrieve-a-state.md) for agencies, statuses, and county requirements.

## Errors

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.