---
title: "ListDeployments lists deployments for a project."
method: GET
path: "/v1/orgs/{org}/projects/{project}/deployments"
---

# ListDeployments lists deployments for a project.

`GET /v1/orgs/{org}/projects/{project}/deployments`

## Path parameters

- `org` string, required
- `project` string, required

## Query parameters

- `environment` string
- `branch` string
- `userId` string

## Response `200`

A successful response.

- V1ListDeploymentsResponse
  - `deployments` V1Deployment[]
    - `branch` string
    - `createdOn` string, date-time
    - `editable` boolean
    - `environment` string
    - `id` string
    - `ownerUserId` string
    - `projectId` string
    - `runtimeHost` string
    - `runtimeInstanceId` string
    - `status` 'DEPLOYMENT_STATUS_UNSPECIFIED' | 'DEPLOYMENT_STATUS_PENDING' | 'DEPLOYMENT_STATUS_RUNNING' | 'DEPLOYMENT_STATUS_ERRORED' | 'DEPLOYMENT_STATUS_STOPPED' | 'DEPLOYMENT_STATUS_UPDATING' | 'DEPLOYMENT_STATUS_STOPPING' | 'DEPLOYMENT_STATUS_DELETING' | 'DEPLOYMENT_STATUS_DELETED'
    - `statusMessage` string
    - `updatedOn` string, date-time
    - `usedOn` string, date-time

## Other responses

- `default` — An unexpected error response.

## Changes

> 54 revisions in range; 1 could not be searched.

- **2026-05-06** (v1) `0aeb660cd27f` — 1 info
  - added the optional property `deployments/items/usedOn` to the response with the `200` status
- **2025-12-23** (v1) `5018914f099f` — 1 info
  - added the new optional `query` request parameter `branch`
- **2025-12-11** (v1) `f317ff96998d` — 2 warning
  - deleted the `query` request parameter `branch`
  - removed the optional property `deployments/items/usedOn` from the response with the `200` status

[Change history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/projects/:project/deployments/get.md)

---

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