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

Parameter

Type

Description

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	CountryWithRegionsWithCities	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	RegionWithCities[]	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

json
{
  "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
        }
      ]
    }
  ]
}