• Home
  • Dynatrace API
  • Account management
  • Environment management

Environment management API - GET all environments of an account

Lists all environments and management zones of an account.

The request produces an application/json payload.

GET

https://api.dynatrace.com/env/v1/accounts/{accountUuid}/environments

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

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

You can find the UUID on the Account > Account management API page, during creation of an OAuth client.

pathrequired

Response

Response codes

CodeTypeDescription
200EnvironmentResourceDto

Success. The response contains a list of the account's environments.

Response body objects

The EnvironmentResourceDto object

ElementTypeDescription
tenantResourcesTenantResourceDto[]

A list of environments in the account.

managementZoneResourcesManagementZoneResourceDto[]

A list of management zones in the account.

The TenantResourceDto object

ElementTypeDescription
namestring

The name of the environment.

idstring

The ID of the environment.

The ManagementZoneResourceDto object

ElementTypeDescription
parentstring

The ID of the environment to which the management zone belongs.

namestring

The name of the management zone.

idstring

The ID of the management zone.

Response body JSON model

json
{ "tenantResources": [ { "name": "string", "id": "string" } ], "managementZoneResources": [ { "parent": "string", "name": "string", "id": "string" } ] }

Example

In this example, the request lists all environments and management zones of the account with the UUID of 9ad20784-76c6-4167-bfba-9b0d8d72a71d.

Curl

bash
curl --request GET \ --url 'https://api.dynatrace.com/env/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/environments' \ --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

plaintext
https://api.dynatrace.com/env/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/environments

Response body

json
{ "tenantResources": [ { "name": "Sample environment", "id": "mySampleEnv" }, { "name": "Sample environment - staging", "id": "mySampleEnvStaging" } ], "managementZoneResources": [ { "name": "mobile app only", "id": "154240256445017454", "parent": "mySampleEnv" }, { "name": "load tests only", "id": "144245256741917454", "parent": "mySampleEnvStaging" } ] }

Response code

200