Get states

Get the states/regions for the given country_code as {label, value} pairs, ordered by name. The endpoint caches the result forever under states_list_v2_{country_code}.

Auth: Both — no authentication required. Public reference endpoint under the group (called by the SPA before login); no role scoping — same global list for everyone.

Rate limit: 100 requests/min.

Request

  • Query: country_code (string, required) — must be a known country code.

Response{ data. } envelope.

  • data (array of objects) — states for that country.
  • value (string) — state code.
  • label (string) — state name.

Errors: 422 on validation failure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Required — ISO-2 country code

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json