Geographic regions API - GET cities of a region
Lists cities of a region.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/rum/cities/{countryCode}/{regionCode} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/rum/cities/{countryCode}/{regionCode} | |
Environment ActiveGate | https://{your-activegate-domain}/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
Parameter | Type | Description | In | Required |
---|---|---|---|---|
countryCode | string | The ISO code of the required country. To fetch the list of available country codes, use the GET all countries request. | path | required |
regionCode | string | The code of the required region. To fetch the list of available region codes, use the GET regions of the country request. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Country | Success. The response contains the list of region's cities. |
404 | ErrorEnvelope | Failed. The requested resource doesn't exist. |
Response body objects
The CountryWithRegionsWithCities
object
Information about a country.
Element | Type | Description |
---|---|---|
countryName | string | The name of the country. |
countryCode | 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 RegionWithCities
object
Information about a country's region and its cities.
Element | Type | Description |
---|---|---|
name | string | The name of the region. |
code | string | The code of the region. |
cityCount | integer | The number of cities in a region of a country. |
cities | City[] | The list of cities in the region. |
The City
object
Information about a city.
Element | Type | Description |
---|---|---|
name | string | The name of the city. |
latitude | number | The latitude of the city. |
longitude | number | The longitude of the city. |
Response body JSON model
{
"countryName": "France",
"countryCode": "FR",
"regionCount": 13,
"regions": [
{
"name": "Auvergne-Rhone-Alpes",
"code": "ARA",
"cityCount": 4,
"cities": [
{
"name": "Abondance",
"latitude": 46.2806,
"longitude": 6.7217
},
{
"name": "Abrest",
"latitude": 46.1008,
"longitude": 3.4463
}
]
}
]
}