Geographic regions API - GET regions

Lists countries and their regions.

The request produces an application/json payload.

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/rum/regions`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/rum/regions`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/rum/regions`

Authentication

To execute this request, you need an access token with Read Geographic regions (geographicRegions.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

Code	Type	Description
200	CountryListWithRegions	Success. The response contains the list of countries with regional divisions.

Response body objects

The `CountryListWithRegions` object

A list of countries with their regions.

Element	Type	Description
countryCount	integer	The number of countries.
countries	Country[]	The list of countries.

The `Country` object

Information about a country.

Element	Type	Description
name	string	The name of the country.
code	string	The ISO code of the country.
regions	Region[]	The list of regions in the country.

The `Region` object

Information about a country's region.

Element	Type	Description
name	string	The name of the region.
code	string	The code of the region.
cities	City[]	The list of cities in the region.

The `City` object

Information about a city.

Element	Type	Description
name	string	The name of the city.
latitude	number	The latitude of the city.
longitude	number	The longitude of the city.

Response body JSON model

json
{
  "countryCount": 252,
  "countries": [
    {
      "name": "France",
      "code": "FR",
      "regionCount": 13,
      "regions": [
        {
          "name": "Auvergne-Rhone-Alpes",
          "code": "ARA"
        },
        {
          "name": "Bourgogne-Franche-Comte",
          "code": "BFC"
        }
      ]
    },
    {
      "name": "Belgium",
      "code": "BE",
      "regionCount": 11,
      "regions": [
        {
          "name": "Antwerp Province",
          "code": "01"
        },
        {
          "name": "Brussels Captial",
          "code": "11"
        }
      ]
    }
  ]
}