Geographic regions API - GET regions

Lists countries and their regions.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`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 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	CountryRegions[]	The list of countries.

The `CountryRegions` object

Information about a country.

Element	Type	Description
name	string	The name of the country.
code	string	The ISO code of the country.
regionCount	integer	The number of regions in 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.

Response body JSON model

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