Get States by Country
GET/static/countries/:countryTwoLetterCode/states
Retrieves a list of states/provinces/subdivisions for a given country code. The country code must be a valid ISO 3166-1 alpha-2 format (e.g., "US", "CA", "GB"). Results are sorted alphabetically by state name and cached for improved performance.
Rate limit: 300 requests per minute per account and credential type, shared across all read endpoints. Exceeding it returns 429 with a Retry-After header.
Request
Responses
- 200
- 400
- 401
- 404
- 422
- 429
- 500
States retrieved successfully
Invalid country code format
Authentication required
No states found
Validation error
Rate limit: 300 requests per minute per account and credential type, shared across all read endpoints. Exceeding it returns 429 with a Retry-After header.
Failed to retrieve states