Geo

📘

Caching on edge locations

To improve performance and reduce latency, this endpoint leverages a distributed caching system. Processes are in place to invalidate this cache automatically whenever required. However, due to the geographically distributed nature of the caching system (edge locations), propagation might take up to 30 minutes to reach all locations.

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 from which the request originated, which is automatically detected.

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.

List of countries

The list of countries returned by this endpoint aligns with ISO 3166-1 standards, which officially assigns codes for sovereign states, dependent territories which are areas under the partial or full administrative control of another country (e.g., Guam for the US) and to special areas of geographical interest (e.g., Taiwan).

Supported languages