Source: https://www.puesto.dev/docs/api/locations/list-states
Markdown source: https://www.puesto.dev/docs/api/locations/list-states.md
Description: List the states / admin-1 regions of a country available as `state` filter values. Each `code` (e.g. `US-CA`) is the exact value the jobs `state` filter accepts.

# List states

`GET /api/v1/locations/states`

List the states / admin-1 regions of a country available as `state` filter values. Each `code` (e.g. `US-CA`) is the exact value the jobs `state` filter accepts.

## Parameters

### Query parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | Yes | ISO 3166-1 alpha-2 country code to list regions for (2 letters, case-insensitive). |

## Response

The available states / regions.

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | object[] | The states / regions of the requested country usable as `state` filter values. |

## Authentication

Send your secret API key (prefixed `sk_`) as a bearer token in the `Authorization` header. See [Authentication](https://www.puesto.dev/docs/authentication.md).

## Errors

Errors use the RFC 7807 `application/problem+json` format. See [Errors](https://www.puesto.dev/docs/errors.md).

## Example request

```bash
curl -X GET "https://www.puesto.dev/api/v1/locations/states" \
  -H "Authorization: Bearer sk_your_key_here"
```

Full spec: https://www.puesto.dev/api/v1/openapi.json