Geographic regions API - GET regions of a country

Lists regions of a country.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/rum/regions/{countryCode}
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/rum/regions/{countryCode}

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

ParameterTypeDescriptionInRequired
countryCodestring

The ISO code of the required country.

To fetch the list of available country codes, use the GET all countries request.

pathrequired

Response

Response codes

CodeTypeDescription
200CountryWithRegions

Success. The response contains the list of country's regions.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The CountryWithRegions object

Information about a country.

ElementTypeDescription
countryCodestring

The ISO code of the country.

countryNamestring

The name of the country.

regionCountinteger

The number of regions in the country.

regionsRegion[]

The list of regions in the country.

The Region object

Information about a country's region.

ElementTypeDescription
codestring

The code of the region.

namestring

The name of the region.

Response body JSON model

{
"countryCode": "FR",
"countyName": "France",
"regionCount": 2,
"regions": [
{
"code": "ARA",
"name": "Auvergne-Rhone-Alpes"
},
{
"code": "BFC",
"name": "Bourgogne-Franche-Comte"
}
]
}