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

# List project deployments

`GET /api/v1/projects/{id}/deployments`

## Request

- Base URL: `https://previewdrop.dev`
- URL: `https://previewdrop.dev/api/v1/projects/{id}/deployments`
- Auth: HTTP bearer

Returns deployments for a specific project, ordered by creation time (newest first). Use the `limit` parameter to control how many results are returned (max 100, default 20). Useful in CI scripts to check the recent deployment history for a project.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

OK

- object
  - `deployments` object[], required
    - `id` string, uuid
    - `status` 'queued' | 'building' | 'deploying' | 'ready' | 'failed' | 'expired' | 'stopped'
    - `branch` string
    - `commit_sha` string, nullable
    - `url` string, uri, nullable
    - `framework` string, nullable
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `404`: Project not found or does not belong to your workspace.
- `429`: You have exceeded the rate limit. Check the `Retry-After` header for when to resume. The limit value reflects the specific endpoint's cap (10, 60, or 120 req/60s — see Rate Limits in the overview).

---

[API](https://skmtc.dev/previewdrop/apis/previewdrop-api.md) · [All operations](https://skmtc.dev/previewdrop/apis/previewdrop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/previewdrop/apis/previewdrop-api/revisions/0742e253496b?raw)