---
title: "Find Deployments"
method: GET
path: "/deployments"
tags: ["deployments"]
---

# Find Deployments

`GET /deployments`

Find deployments by project and chat IDs. This will return a list of deployments for the given project and chat IDs.

## Query parameters

- `projectId` string, required — The ID of the project to find deployments for
- `chatId` string, required — The ID of the chat to find deployments for
- `versionId` string, required — The ID of the version to find deployments for

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` DeploymentDetail[], required
    - `id` string, required — A unique identifier for the deployment.
    - `object` 'deployment', required — Fixed value identifying this object as a deployment.
    - `inspectorUrl` string, required — URL to the deployment inspector.
    - `chatId` string, required — The ID of the chat that this deployment is scoped to.
    - `projectId` string, required — The ID of the project that this deployment is scoped to.
    - `versionId` string, required — The ID of the version that this deployment is scoped to.
    - `apiUrl` string, uri, required — The API endpoint URL for accessing this deployment programmatically.
    - `webUrl` string, uri, required — The web URL where the deployment can be viewed or managed.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-08-24** `3521652a43a7` — 1 breaking, 1 info
  - the `query` request parameter `projectId` became required
  - the response property `data/items/projectId` became required for the status `200`

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/deployments/get.md)

---

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