---
title: "Get deployment"
method: GET
path: "/api/v1/deployments/{deploymentId}"
tags: ["deployments"]
---

# Get deployment

`GET /api/v1/deployments/{deploymentId}`

Retrieve information about a specific deployment by its ID.

## Response `200`

Successful request

- object
  - `id` string — The deployment ID
  - `status` 'PENDING' | 'INSTALLING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'FAILED' | 'CANCELED' | 'TIMED_OUT' — The current status of the deployment
  - `contentHash` string — Hash of the deployment content
  - `shortCode` string — The short code for the deployment
  - `version` string — The deployment version (e.g., "20250228.1")
  - `imageReference` string, nullable — Reference to the deployment image
  - `imagePlatform` string — Platform of the deployment image
  - `externalBuildData` object, nullable — External build data if applicable
  - `errorData` object, nullable — Error data if the deployment failed
  - `worker` object, nullable — Worker information if available
    - `id` string
    - `version` string
    - `tasks` object[]
      - `id` string
      - `slug` string
      - `filePath` string
      - `exportName` string

## Other responses

- `401` — Unauthorized - Access token is missing or invalid
- `404` — Deployment not found

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/versions/737c498e605b/schema)