Geographic regions API - GET cities of a region

Lists cities of a region.

The request produces an application/json payload.

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

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
regionCodestring

The code of the required region.

To fetch the list of available region codes, use the GET regions of the country request.

pathrequired

Response

Response codes

CodeTypeDescription
200CountryWithRegionsWithCities

Success. The response contains the list of region's cities.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The CountryWithRegionsWithCities 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.

regionsRegionWithCities[]

The list of regions in the country.

The RegionWithCities object

Information about a country's region and its cities.

ElementTypeDescription
citiesCity[]

The list of cities in the region.

cityCountinteger

The number of cities in a region of a country.

codestring

The code of the region.

namestring

The name of the region.

The City object

Information about a city.

ElementTypeDescription
latitudenumber

The latitude of the city.

longitudenumber

The longitude of the city.

namestring

The name of the city.

Response body JSON model

{
"countryCode": "FR",
"countryName": "France",
"regionCount": 13,
"regions": [
{
"cities": [
{
"latitude": 46.2806,
"longitude": 6.7217,
"name": "Abondance"
},
{
"latitude": 46.1008,
"longitude": 3.4463,
"name": "Abrest"
}
],
"cityCount": 4,
"code": "ARA",
"name": "Auvergne-Rhone-Alpes"
}
]
}