---
title: "List releases"
method: GET
path: "/v2/app/{appId}/releases"
tags: ["release"]
---

# List releases

`GET /v2/app/{appId}/releases`

## Request

- Base URL: `https://api.runway.team`
- URL: `https://api.runway.team/v2/app/{appId}/releases`
- Auth: API key in header `X-API-Key`

## Path parameters

- `appId` string, required

## Query parameters

- `timelinePhase` 'upcoming' | 'current' | 'completed': The timeline phase of the release
- `limit` integer
- `offset` integer

## Response `200`

A list of releases

- Release[]
  - `id` string, required: The id of the release
  - `version` string, required: The release version
  - `displayableVersion` string: Human-readable version
  - `status` 'active' | 'completed' | 'canceled', required: The status of a release
  - `type` 'major' | 'minor' | 'point' | 'hotfix' | 'rollback', required: The type of release
  - `timelinePhase` 'upcoming' | 'current' | 'completed', required: The timeline phase of the release
  - `releaseBranch` string: The detected release branch for the release
  - `createdAt` string, date-time, required: The date and time when the release was created in Runway
  - `updatedAt` string, date-time: The date and time when the release was last updated in Runway
  - `completedAt` string, date-time: The date and time when the release was marked as completed in Runway.
  - `targetKickoffDate` string, date-time: The target kickoff date and time for the release
  - `targetSubmissionDate` string, date-time: The target submission date and time for the release
  - `targetReleaseDate` string, date-time: The target release date and time for the release
  - `releasePilotId` string: The release pilot for the release
  - `releaseSummary` string: The automatically generated summary of the release.
  - `releaseDescription` string: Free-text description / planning summary for the release.

## Other responses

- `404`: Resource not found response

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)