Geographic regions API - GET cities of a region
Lists cities of a region.
The request produces an application/json payload.
| GET | Managed | 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 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 |
| regionCode | string | Specify the region 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 RegionList object
An ordered list of regions for a given 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",
"cities": [
{
"name": "Abondance",
"latitude": 46.2806,
"longitude": 6.7217
},
{
"name": "Abrest",
"latitude": 46.1008,
"longitude": 3.4463
}
]
}
]
}