---
title: "Retrieves the status of a deployment by deployment ID."
method: GET
path: "/deployments/{deploymentId}"
tags: ["Deployments"]
---

# Retrieves the status of a deployment by deployment ID.

`GET /deployments/{deploymentId}`

## Request

- Base URL: `https://api.acquia.com/v3`
- URL: `https://api.acquia.com/v3/deployments/{deploymentId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/docs/deployments/:deploymentId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `deploymentId` string, required

## Response `200`

Deployment details

- object: Deployment properties
  - `id` string, required: Unique identifier for the deployment.
  - `environment_id` string, required: Identifier of the environment this deployment belongs to.
  - `status` 'waiting' | 'received' | 'started' | 'done' | 'failed' | 'error' | 'killed', required: Current status of the deployment.
  - `code_reference` string, required: The code reference (e.g. branch or tag) deployed.
  - `run_hooks` boolean, required: Whether deployment hooks were run.
  - `hooks_argument` string, nullable: Additional arguments passed to deployment hooks.
  - `created_at` string, date-time, required: Timestamp when the deployment was created.
  - `started_at` string, date-time, nullable: Timestamp when the deployment started.
  - `completed_at` string, date-time, nullable: Timestamp when the deployment completed.
  - `sender_id` string, nullable: Identifier of the user or system that initiated the deployment.
  - `logs` string, nullable: Deployment log output.
  - `_links` object, required: HAL links for the resource
    - `self` EnvironmentServiceAPIHalLink, required: HAL link object
      - `href` union, required: The target URI of the link (can be a URI or URI template)
        - string, uri
        - string, uri-template
      - `templated` boolean: Whether the link is a URI template
      - `type` string: Hint about the media type expected when dereferencing the target resource
      - `deprecation` string: A URL to a resource that provides deprecation information
      - `name` string: A secondary key for selecting links
      - `profile` string: A URI that hints about the profile of the target resource
      - `title` string: A human-readable identifier for the link
      - `hreflang` string: The language of the target resource
  - `_embedded` object: Embedded resources (optional)

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api.md) - [All operations](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/revisions/508f8f94456d?raw)