Reference data API - GET geographical regions

Lists all geographical regions that your account uses.

The request produces an application/json payload.

GET	`https://api.dynatrace.com/ref/v1/regions`

Authentication

To execute this request, you need the Allow read access for environment resources (account-env-read) scope assigned to your token. To learn how to obtain and use it, see Authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

Code	Type	Description
200	RegionDto[]	Success. The response contains the list of regions.

Response body objects

The `ResponseBody` object

The object doesn't provide any parameters.

The `RegionDto` object

Element	Type	Description
name	string	The name of the region.

Response body JSON model

json
[
  {
    "name": "string"
  }
]

Example

In this example, the request lists all regions of the account with the UUID of 9ad20784-76c6-4167-bfba-9b0d8d72a71d. The result is truncated to two entries.

Curl

bash
curl --request GET \
  --url https://api.dynatrace.com/ref/v1/regions \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

plaintext
https://api.dynatrace.com/ref/v1/regions

Response body

json
[
  {
    "name": "US East Virginia"
  },
  {
    "name": "US West Oregon"
  }
]

Response code

200