Puesto Docs
API ReferenceLocationsList states GET

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.

Authorization

bearerAuth
AuthorizationBearer <token>

Provide your secret API key (prefixed sk_) as a bearer token: Authorization: Bearer sk_....

In: header

Query Parameters

country*string

ISO 3166-1 alpha-2 country code to list regions for (2 letters, case-insensitive).

Length2 <= length <= 2

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/locations/states?country=st"
{  "data": [    {      "code": "string",      "admin1_code": "string",      "name": "string",      "slug": "string"    }  ]}
{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}
{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}
{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}