• Home
  • Dynatrace API
  • Environment
  • RUM
  • Geographic regions
  • GET regions

Geographic regions API - GET regions

Lists countries and their regions.

The request produces an application/json payload.

GETManaged 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

CodeTypeDescription
200CountryListWithRegions

Success

Response body objects

The CountryListWithRegions object

An ordered list of countries with their regions

ElementTypeDescription
countryCountinteger

Number of countries

Can be null.

countriesCountry[]

An ordered list of countries.

Can be null.

The Country object

The information about a country

ElementTypeDescription
namestring

Country name

Can be null.

codestring

Country code

Can be null.

regionsRegion[]

An ordered list of regions for a given country.

Can be null.

The Region object

The information about a region for a given country

ElementTypeDescription
namestring

Region name

Can be null.

codestring

Region code

Can be null.

citiesCity[]

An order list of cities for a given region

Can be null.

The City object

The information about a city

ElementTypeDescription
namestring

City name

Can be null.

latitudenumber

Latitude of city

Can be null.

longitudenumber

Longitude of city

Can be null.

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" } ] } ] }
Related topics
  • Real User Monitoring

    Learn about Real User Monitoring, key performance metrics, mobile app monitoring, and more.

  • Detection of IP addresses, geolocations, and user agents

    Learn how Dynatrace detects IP addresses and geolocations like a city, region, and country as well as browsers, devices, and operating systems.