---
title: "List recent deployments"
method: GET
path: "/apps/{appRef}/deploys"
tags: ["Deploys"]
---

# List recent deployments

`GET /apps/{appRef}/deploys`

## Request

- Base URL: `https://api.percher.run`
- URL: `https://api.percher.run/apps/{appRef}/deploys`
- Auth: HTTP bearer

## Path parameters

- `appRef` string, required

## Query parameters

- `limit` integer
- `type` 'live' | 'preview'

## Response `200`

Array of deployments

- Deployment[]
  - `id` string
  - `appId` string
  - `status` 'queued' | 'building' | 'deploying' | 'live' | 'failed'
  - `type` 'live' | 'preview'
  - `previewSlug` string, nullable
  - `buildLog` string, nullable
  - `errorMessage` string, nullable
  - `errorCode` 'WORKER_UNAVAILABLE' | 'WORKER_UNAVAILABLE_PERSISTENT' | 'BUILD_TIMEOUT' | 'BUILD_FAILED' | 'WORKER_ERROR' | 'DEPLOY_STALLED', nullable
  - `containerId` string, nullable
  - `commitSha` string, nullable
  - `expiresAt` string, date-time, nullable
  - `createdAt` string, date-time
  - `finishedAt` string, date-time, nullable

---

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