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

# List deployments

`GET /deployments`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/deployments`
- Auth: HTTP bearer

Read-only. Returns the most-recent deployments first (capped at 50 by default, max 500). Supports filtering by `appId`, `status`, `platform`, `releaseId`, `triggeredByUid` query params (any combination).

## Query parameters

- `appId` string
- `status` string
- `platform` string
- `releaseId` string
- `triggeredByUid` string
- `limit` integer

## Response `200`

Deployments matching the filters, newest-first

- object
  - `deployments` Deployment[]
    - `id` string, required
    - `appId` string, nullable
    - `appName` string, nullable
    - `platform` 'android' | 'ios' | 'web' | 'backend', nullable
    - `targetId` string, nullable: e.g. `play:internal`, `ghenv:staging`.
    - `targetDisplayName` string, nullable
    - `buildVersion` string, nullable
    - `versionCode` string, nullable
    - `status` 'pending' | 'building' | 'deploying' | 'success' | 'failed' | 'cancelled' | 'testsFailed', required
    - `statusMessage` string, nullable
    - `errorMessage` string, nullable
    - `githubRunId` string, nullable
    - `githubRunUrl` string, nullable
    - `triggeredByUid` string, nullable
    - `triggeredByName` string, nullable
    - `releaseId` string, nullable
    - `releaseVersion` string, nullable
    - `snapshotId` string, nullable
    - `createdAt` string, date-time, nullable
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)