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

CodeTypeDescription
200RegionDto[]

Success. The response contains the list of regions.

Response body objects

The ResponseBody object

The RegionDto object

ElementTypeDescription
namestring

The name of the region.

Response body JSON model

[
  {
    "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

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

Request URL

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

Response body

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

Response code

200