---
title: "List terraform deployments"
method: GET
path: "/terraform/{terraformId}/deploymentHistoryV2"
tags: ["Terraform Deployment History"]
---

# List terraform deployments

`GET /terraform/{terraformId}/deploymentHistoryV2`

## Request

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

Returns the 20 last terraform deployments

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