---
title: "List an environment's data planes"
method: GET
path: "/organizations/{orgId}/environments/{envId}/dataplanes"
tags: ["Data Planes"]
---

# List an environment's data planes

`GET /organizations/{orgId}/environments/{envId}/dataplanes`

## Request

- Base URL: `http://localhost:8093/automation`
- URL: `http://localhost:8093/automation/organizations/{orgId}/environments/{envId}/dataplanes`
- Auth: HTTP bearer

Returns all data planes managed by the Automation API in the environment. Data planes provisioned outside the Automation API are not returned.

## Path parameters

- `orgId` string, required
- `envId` string, required

## Response `200`

List of data planes

- AutomationDataPlane[]
  - `configuration` object: Connection settings. Write-only: it can hold credentials.
  - `createdAt` string, date-time: Creation timestamp (ISO-8601 / RFC 3339, UTC). Read-only.
  - `database` string: Name of the database the configuration points at. Read-only.
  - `environmentId` string: Identifier of the environment the data plane belongs to. Read-only.
  - `gatewayUrl` string: Base URL of the gateway serving the domains bound to this data plane. Must be an absolute http(s) URL with a lowercase scheme; omitted or empty leaves it unset.
  - `hosts` string[]: Hosts the configuration points at, as host:port. Read-only.
  - `id` string, required: Stable, immutable identifier for the data plane within its environment. Lowercase alphanumeric and hyphens, starting and ending with an alphanumeric character. This is the value a domain's dataPlaneId refers to.
  - `name` string: Human-readable name of the data plane.
  - `organizationId` string: Identifier of the organization the data plane belongs to. Read-only.
  - `type` string: Data plane plugin type identifier, matching the dataplane-am-<type> plugin. Immutable after creation.
  - `updatedAt` string, date-time: Last-update timestamp (ISO-8601 / RFC 3339, UTC). Read-only.

## Other responses

- `403`: Permission denied
- `default`: Unexpected error

## Changes

- **2026-09-29** `821321fb3bcf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-am-automation-api/changes/organizations/:orgId/environments/:envId/dataplanes/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-am-automation-api.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-am-automation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-am-automation-api/revisions/b0b6bdfd65cb?raw)