Geographic regions API - GET regions of a country
Lists regions of a country.
The request produces an application/json payload.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/rum/regions/{countryCode} |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/rum/regions/{countryCode} | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/rum/regions/{countryCode} |
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
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| countryCode | string | Specify the country code to query. | path | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Region | Success |
| 404 | Error | Failed. The requested resource doesn't exist. |
Response body objects
The RegionListSingleCountry object
An ordered list of regions for a single country
| Element | Type | Description |
|---|---|---|
| countryName | string | Country name Can be |
| countryCode | string | Country code Can be |
| regionCount | integer | Number of regions Can be |
| regions | Region[] | An ordered list of regions. Can be |
The Region object
The information about a region for a given country
| Element | Type | Description |
|---|---|---|
| name | string | Region name Can be |
| code | string | Region code Can be |
| cities | City[] | An order list of cities for a given region Can be |
The City object
The information about a city
| Element | Type | Description |
|---|---|---|
| name | string | City name Can be |
| latitude | number | Latitude of city Can be |
| longitude | number | Longitude of city Can be |
Response body JSON model
{
"countryName": "France",
"countryCode": "FR",
"regionCount": 13,
"regions": [
{
"name": "Auvergne-Rhone-Alpes",
"code": "ARA"
},
{
"name": "Bourgogne-Franche-Comte",
"code": "BFC"
}
]
}