---
title: "List project deployments"
method: GET
path: "/v1/projects/{projectId}/deployments"
tags: ["deployments"]
---

# List project deployments

`GET /v1/projects/{projectId}/deployments`

List all deployments for a project

## Path parameters

- `projectId` string, required — The ID of the project

## Query parameters

- `status` string[] — Filter by one or more statuses
- `environmentId` string — Filter by environment ID

## Response `200`

The list of deployments

- object[]
  - `id` string, required
  - `status` 'ongoing' | 'deployed' | 'failed' | 'canceled', required
  - `sourceRef` string, nullable, required
  - `sourceCommitId` string, nullable, required
  - `sourceCommitMessage` string, nullable, required
  - `authorUsername` string, nullable, required
  - `authorAvatarUrl` string, nullable, required
  - `startedAt` string, date-time, nullable, required
  - `completedAt` string, date-time, nullable, required
  - `environmentId` string, required
  - `environmentName` string, required
  - `isCurrent` boolean, required
  - `deploymentPageUrl` string, uri, nullable, required

## Other responses

- `400` — 400
- `404` — 404

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c2f44f4cfd87` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alpic/apis/alpic-api/changes/v1/projects/:projectId/deployments/get.md)

---

[API](https://skmtc.dev/alpic/apis/alpic-api.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api/revisions/262875478562/schema)
