---
title: "List environment deployments"
method: GET
path: "/environment/{environmentId}/deploymentHistoryV2"
tags: ["Environment Deployment History"]
---

# List environment deployments

`GET /environment/{environmentId}/deploymentHistoryV2`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/environment/{environmentId}/deploymentHistoryV2`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/environment/:environmentId/deploymentHistoryV2/get.ts> (a function with typed inputs; its response is checked against the schema)

List previous and current environment deployments with the status deployment and the related services. By default it returns the 20 last results. The response is paginated. In order to request the next page, you can use the startId query parameter

## Query parameters

- `pageSize` number, nullable

## Response `200`

List deployment history

- DeploymentHistoryEnvironmentPaginatedResponseListV2
  - `page` number, required
  - `page_size` number, required
  - `results` DeploymentHistoryEnvironmentV2[]
    - `identifier` object, required
      - `execution_id` string, required
      - `environment_id` string, uuid, required
    - `auditing_data` DeploymentHistoryAuditingData, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `triggered_by` string, required
      - `origin` 'API' | 'CLI' | 'CONSOLE' | 'GIT' | 'QOVERY_INTERNAL' | 'TERRAFORM_PROVIDER': Origin of the organization event
    - `status` 'BUILDING' | 'BUILD_ERROR' | 'CANCELED' | 'CANCELING' | 'DELETED' | 'DELETE_ERROR' | 'DELETE_QUEUED' | 'DELETING' | 'DEPLOYED' | 'DEPLOYING' | 'DEPLOYMENT_ERROR' | 'DEPLOYMENT_QUEUED' | 'EXECUTING' | 'QUEUED' | 'READY' | 'RECAP' | 'RESTARTED' | 'RESTARTING' | 'RESTART_ERROR' | 'RESTART_QUEUED' | 'STOPPED' | 'STOPPING' | 'STOP_ERROR' | 'STOP_QUEUED' | 'WAITING_DELETING' | 'WAITING_RESTARTING' | 'WAITING_RUNNING' | 'WAITING_STOPPING', required
    - `trigger_action` 'DEPLOY' | 'DELETE' | 'RESTART' | 'STOP' | 'UNKNOWN' | 'UNINSTALL', required
    - `total_duration` string, duration, required
    - `stages` DeploymentHistoryStage[], required
      - `name` string, required
      - `status` 'QUEUED' | 'ONGOING' | 'DONE' | 'ERROR' | 'SKIPPED' | 'CANCELED', required
      - `duration` string, duration, required
      - `services` DeploymentHistoryService[], required
        - `identifier` object, required
          - `name` string, required
          - `service_id` string, uuid, required
          - `service_type` 'APPLICATION' | 'DATABASE' | 'CONTAINER' | 'JOB' | 'HELM' | 'TERRAFORM', required: type of the service (application, database, job, ...)
          - `execution_id` string
        - `status` 'BUILDING' | 'BUILD_ERROR' | 'CANCELED' | 'CANCELING' | 'DELETED' | 'DELETE_ERROR' | 'DELETE_QUEUED' | 'DELETING' | 'DEPLOYED' | 'DEPLOYING' | 'DEPLOYMENT_ERROR' | 'DEPLOYMENT_QUEUED' | 'EXECUTING' | 'QUEUED' | 'READY' | 'RECAP' | 'RESTARTED' | 'RESTARTING' | 'RESTART_ERROR' | 'RESTART_QUEUED' | 'STOPPED' | 'STOPPING' | 'STOP_ERROR' | 'STOP_QUEUED' | 'WAITING_DELETING' | 'WAITING_RESTARTING' | 'WAITING_RUNNING' | 'WAITING_STOPPING', required
        - `auditing_data` DeploymentHistoryAuditingData, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
          - `triggered_by` string, required
          - `origin` 'API' | 'CLI' | 'CONSOLE' | 'GIT' | 'QOVERY_INTERNAL' | 'TERRAFORM_PROVIDER': Origin of the organization event
        - `details` union, required
          - object: ApplicationDeploymentHistoryData
            - `commit` Commit, nullable, required
              - …
          - object: ContainerDeploymentHistoryData
            - `image_name` string, required
            - `tag` string, required
            - `arguments` string[], required
            - `entrypoint` string
          - object: JobDeploymentHistoryDetails
            - `image_name` string, required
            - `tag` string, required
            - `commit` Commit, nullable
              - …
            - `schedule` object
              - …
            - `job_type` 'CRON' | 'LIFECYCLE', required
          - object: HelmDeploymentHistoryDetails
            - `commit` Commit, nullable
              - …
            - `repository` object
              - …
        - `status_details` StatusDetails
          - `action` 'DEPLOY' | 'DELETE' | 'RESTART' | 'STOP' | 'UNKNOWN', required
          - `status` 'QUEUED' | 'ONGOING' | 'SUCCESS' | 'ERROR' | 'EXECUTING' | 'CANCELED' | 'CANCELING' | 'NEVER', required
        - `icon_uri` string, uri, required
        - `total_duration` string, duration
    - `action_status` 'QUEUED' | 'ONGOING' | 'SUCCESS' | 'ERROR' | 'CANCELED' | 'CANCELING' | 'NEVER', required

## Other responses

- `401`: Access token is missing or invalid
- `403`: Access forbidden
- `404`: Resource not found

---

[API](https://skmtc.dev/qovery/apis/qovery-api.md) - [All operations](https://skmtc.dev/qovery/apis/qovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qovery/apis/qovery-api/revisions/93c4960a44ba?raw)