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
}
]
}
]
}