Skip to main content
GET
List country states

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Get your API key from the Reply dashboard: Settings → API Key.

Query Parameters

countryCode
string
required

ISO 3166-1 alpha-2 country code, exactly 2 Latin letters, case-insensitive, e.g. US

Required string length: 2

Response

States and regions of the requested country

states
string[]
required

State and region names, sorted alphabetically. Empty when the country has no regions.