Remote environments API - GET all environments

Lists all remote environment configurations.

The request produces an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/remoteEnvironments
  • SaaS https://{your-environment-id}


The request doesn't provide any configurable parameters.

Response format

The RemoteEnvironmentConfigListDto object

Element Type Description
values RemoteEnvironmentConfigStub[]

The RemoteEnvironmentConfigStub object

The short representation of a remote environment.

Element Type Description
id string

The ID of the Dynatrace entity.

name string

The name of the Dynatrace entity.

description string

A short description of the Dynatrace entity.

uri string

The URI of the remote environment.

networkScope string

The network scope of the remote environment:

  • EXTERNAL: The remote environment is located in an another network.
  • INTERNAL: The remote environment is located in the same network.
  • CLUSTER: The remote environment is located in the same cluster.

Dynatrace SaaS can only use EXTERNAL.

If not set, EXTERNAL is used.


In this example, the request asks for a list of all the remote environment configurations in the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to two entries.


curl -X GET \ \
  -H 'Accept: application/json; charset=utf-8' \
  -H 'Authorization: Api-token abcdefjhij1234567890'

Request URL

Response body

  "values": [
      "id": "b597955c-4706-40f6-b188-212faba25e1f",
      "name": "Production North",
      "uri": "",
      "networkScope": "EXTERNAL"
      "id": "4f3b0f62-6ec0-407d-be50-5109a8516edf",
      "name": "Production South",
      "uri": "",
      "networkScope": "EXTERNAL"

Response code