Retrieve list of states/regions for any country.
Description
Use this public endpoint to return a list of states/regions for a specific country, in a specific language (the locale query parameter). You can use this endpoint to auto-populate drop-down menus for countries and related states/regions in a user interface.
If a country code is not specified as a path parameter, the default behavior is to return the list of states/regions based on the country detected from the originating request, which is automatically detected.
As a fallback mechanism, if country cannot be detected, the returned list will be based on the country associated to your account.
If locale is not specified as a query parameter or if it is invalid, the default behavior is to return the list for en_US locale.
Supported languages
| Locale | Description |
|---|---|
| en_US | English - United States |
| fr_CA | French - Canada |
| it_IT | Italian - Italy |
| es_ES | Spanish - Spain (Traditional) |
| ko | Korean |