---
title: "List Deployments in an Environment."
method: GET
path: "/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys"
tags: ["public", "Deployment"]
---

# List Deployments in an Environment.

`GET /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys`

List all of the Deployments that have been carried out in the current Environment. Deployments are returned with the newest first.

## Path parameters

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

## Query parameters

- `pipelineRunId` string

## Response `200`

A possibly empty list of Deployments.

- DeploymentResponse[]
  - `comment` string, required — An optional comment to help communicate the purpose of the Deployment.
  - `created_at` string, date-time, required — The Timestamp of when the Deployment was initiated.
  - `created_by` string, required — The user who initiated the Deployment.
  - `delta_id` string — ID of the Deployment Delta describing the changes to the current Environment for this Deployment.
  - `env_id` string, required — The Environment where the Deployment occurred.
  - `export_file` string, required
  - `dependency_graph_id` string — The ID of the Dependency Graph which holds the sorted list of the resources provisioned with this deployment. The referenced Graph does not include resources of type k8s-cluster and k8s-namespace (and logging in case of deployments executed in Operator mode).
  - `legacy_mode` boolean — Defines if it's a Legacy Mode deployment, nil means either the mode is unknown or the deployment not yet finished.
  - `operator_version` string — The version of the Humanitec Operator that performed this Deployment. Only set in Operator Mode; nil if the version is unknown, could not be retrieved, or the Deployment has not yet finished.
  - `mode` string — The deployment mode. Either "full" or "incremental". "incremental" is only valid in direct (non-legacy) mode.
  - `export_status` string, required
  - `from_id` string, required — The ID of the Deployment that this Deployment was based on.
  - `id` string, required — The ID of the Deployment.
  - `pipeline` DeploymentPipelineReferenceResponse
    - `id` string, required — The ID of the Pipeline
    - `job_id` string, required — The ID of the Pipeline Job within the Run.
    - `run_id` string, required — The ID of the Pipeline Run
    - `step_index` integer, required — The index of the step with in the Job.
  - `set_id` string, required — ID of the Deployment Set describing the state of the Environment after Deployment.
  - `status` string, required — The current status of the Deployment. Can be `pending`, `in progress`, `succeeded`, or `failed`.
  - `status_changed_at` string, date-time, required — The timestamp of the last `status` change. If `status` is `succeeded` or `failed` it it will indicate when the Deployment finished.
  - `value_set_version_id` string, nullable — ID of the Value Set Version describe the values to be used for this Deployment.

## Other responses

- `404` — No Environment with `id` in Application.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)