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

# List environment deployments

`GET /environment/{environmentId}/deploymentHistory`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/environment/{environmentId}/deploymentHistory`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/environment/:environmentId/deploymentHistory/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

## Path parameters

- `environmentId` string, uuid, required

## Query parameters

- `startId` string, uuid

## Response `200`

List deployment history

- DeploymentHistoryEnvironmentPaginatedResponseList
  - `page` number, required
  - `page_size` number, required
  - `results` DeploymentHistoryEnvironment[]
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time
    - `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'
    - `origin` 'API' | 'CLI' | 'CONSOLE' | 'GIT' | 'QOVERY_INTERNAL' | 'TERRAFORM_PROVIDER': Origin of the organization event
    - `triggered_by` string
    - `applications` DeploymentHistoryApplication[]
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `name` string
      - `commit` Commit, nullable
        - `created_at` string, date-time, required
        - `git_commit_id` string, required
        - `tag` string, required
        - `message` string, required
        - `author_name` string, required
        - `author_avatar_url` string
        - `commit_page_url` 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'
    - `containers` DeploymentHistoryContainer[]
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `name` string: name of the container
      - `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'
      - `image_name` string
      - `tag` string
      - `arguments` string[]
      - `entrypoint` string
    - `databases` DeploymentHistoryDatabase[]
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `name` string: name of the service
      - `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'
    - `jobs` DeploymentHistoryJobResponse[]
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `name` string: name of the job
      - `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'
      - `image_name` string
      - `tag` string
      - `commit` Commit, nullable
        - `created_at` string, date-time, required
        - `git_commit_id` string, required
        - `tag` string, required
        - `message` string, required
        - `author_name` string, required
        - `author_avatar_url` string
        - `commit_page_url` string
      - `schedule` object
        - `event` 'ON_START' | 'ON_STOP' | 'ON_DELETE' | 'CRON': On which event the job is going to run. ON_START means when a deployment is requested for the environment ON_STOP means when a stop of the environment is requested ON_DELETE means when an environment delete is requested CRON means at a scheduled interval
        - `schedule_at` string, cron, nullable: Can only be set if the event is CRON. Represent the cron format for the job schedule without seconds. For example: `* * * * *` represent the cron to launch the job every minute. See https://crontab.guru/ to WISIWIG interface. Timezone is UTC
      - `arguments` string[]
      - `entrypoint` string
    - `helms` DeploymentHistoryHelmResponse[]
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `name` string: name of the helm
      - `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'
      - `commit` Commit, nullable
        - `created_at` string, date-time, required
        - `git_commit_id` string, required
        - `tag` string, required
        - `message` string, required
        - `author_name` string, required
        - `author_avatar_url` string
        - `commit_page_url` string
      - `repository` object, nullable: If the chart source if from a repository, the chart name and its version
        - `chart_name` string
        - `chart_version` string

## 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)