---
title: "List deployments"
method: GET
path: "/api/v1/apps/services/{service_id}/deployments"
tags: ["Raff Apps"]
---

# List deployments

`GET /api/v1/apps/services/{service_id}/deployments`

## Path parameters

- `service_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Deployments, newest first

- object
  - `success` boolean
  - `deployments` AppDeployment[]
    - `id` string, uuid
    - `service_id` string, uuid
    - `deployment_number` integer
    - `channel` 'console' | 'git_push' | 'cli' | 'compose' | 'rollback'
    - `status` 'queued' | 'building' | 'deploying' | 'live' | 'superseded' | 'failed' | 'canceled'
    - `rollback_of` string, uuid — Set when this deployment is a rollback
    - `image_digest` string
    - `commit_sha` string
    - `commit_message` string
    - `error` string
    - `build_duration_ms` integer
    - `started_at` string, date-time
    - `finished_at` string, date-time
    - `created_at` string, date-time

## Other responses

- `401` — Authentication required

---

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