---
title: "List deployments"
method: GET
path: "/api/v1/deployments"
tags: ["deployments"]
---

# List deployments

`GET /api/v1/deployments`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/deployments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/deployments/get.ts> (a function with typed inputs; its response is checked against the schema)

List deployments for the authenticated environment, ordered by most recent first.

## Query parameters

- `page[after]` string
- `page[size]` integer
- `status` 'PENDING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'FAILED' | 'CANCELED' | 'TIMED_OUT'
- `period` string
- `from` string
- `to` string

## Response `200`

Successful request

- object
  - `data` object[]
    - `id` string: The deployment ID
    - `createdAt` string, date-time: When the deployment was created
    - `shortCode` string: The short code for the deployment
    - `version` string: The deployment version (e.g., "20250228.1")
    - `runtime` string, nullable: The runtime used (e.g., "node")
    - `runtimeVersion` string, nullable: The runtime version
    - `status` 'PENDING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'FAILED' | 'CANCELED' | 'TIMED_OUT': The current status of the deployment
    - `deployedAt` string, date-time, nullable: When the deployment was promoted to DEPLOYED
    - `git` object, nullable: Git metadata associated with the deployment
    - `error` object, nullable: Error data if the deployment failed
    - `externalId` string: The external deployment id this deployment was deployed under (`--external-id`), used by version skew protection to pin runs. Absent if the deployment was deployed without one
  - `pagination` object
    - `next` string: Cursor for the next page. Pass as `page[after]` to get the next page. Omitted if there are no more results.

## Other responses

- `401`: Unauthorized - Access token is missing or invalid

## Changes

- **2026-09-07** `7ba473919f79`: 1 info
  - added the optional property `data/items/externalId` to the response with the `200` status
- **2026-04-14** `737c498e605b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/deployments/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)