---
title: "List application deploys"
method: GET
path: "/application/{applicationId}/deploymentHistoryV2"
tags: ["Application Deployment History"]
---

# List application deploys

`GET /application/{applicationId}/deploymentHistoryV2`

## Request

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

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. You can also filter by status (FAILED or SUCCESS), and git_commit_id

## Query parameters

- `pageSize` number, nullable

## Response `200`

List deployment history

- DeploymentHistoryServicePaginatedResponseListV2
  - `page` number, required
  - `page_size` number, required
  - `results` DeploymentHistoryService[]
    - `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
          - `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
      - 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
          - `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
          - `on_start` JobLifecyleSchedule
            - `arguments` string[], required
            - `entrypoint` string
          - `on_stop` JobLifecyleSchedule
            - `arguments` string[], required
            - `entrypoint` string
          - `on_delete` JobLifecyleSchedule
            - `arguments` string[], required
            - `entrypoint` string
          - `cron_job` JobCronSchedule
            - `arguments` string[], required
            - `entrypoint` string
            - `scheduled_at` string, required
            - `timezone` string, required
          - `lifecycle_type` 'GENERIC' | 'TERRAFORM' | 'CLOUDFORMATION'
        - `job_type` 'CRON' | 'LIFECYCLE', required
      - object: HelmDeploymentHistoryDetails
        - `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
          - `chart_name` string
          - `chart_version` string
    - `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

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