---
title: "Get release schedule"
method: GET
path: "/app/{appId}/releaseSchedule"
tags: ["app", "release"]
---

# Get release schedule

`GET /app/{appId}/releaseSchedule`

## Request

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

Returns each release's target dates (kickoff, submit, release, rollout completion), status, and release pilot. Includes cadence-predicted future releases (status `predicted`) whose dates and pilot are estimates derived from the app's schedule and pilot rotation and are subject to change. Omit `version` for the full schedule (past, current, and predicted future releases); pass it to get a single release. Only available for apps using Runway workflows.

## Path parameters

- `appId` string, required

## Query parameters

- `version` string

## Response `200`

Per-release schedule (target dates and pilot) for an app, ordered chronologically

- ReleaseScheduleEntryEntity[]
  - `version` string, required: The displayable release version.
  - `status` 'active' | 'completed' | 'skipped' | 'deleted' | 'predicted', required: The release status. `predicted` means a cadence-forecasted future release that does not exist yet.
  - `isPredicted` boolean, required: True when this is a cadence-predicted future release whose dates and pilot are estimates.
  - `isHotfix` boolean, required: Whether this release is a hotfix.
  - `releasePilotId` string, nullable: The release pilot's user id (email), if assigned.
  - `kickoffDate` string, date-time, nullable: Target kickoff date/time (earliest across destinations).
  - `submitDate` string, date-time, nullable: Target submit date/time (earliest across destinations).
  - `releaseDate` string, date-time, nullable: Target release date/time (earliest across destinations).
  - `rolloutCompletionDate` string, date-time, nullable: Target rollout completion date/time (earliest across destinations).

## 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)