---
title: "Get release progressions for release pipeline"
method: GET
path: "/api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases"
tags: ["Release pipelines (beta)"]
---

# Get release progressions for release pipeline

`GET /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases`

Get details on the progression of all releases, across all flags, for a release pipeline

## Path parameters

- `projectKey` string, string, required — The project key
- `pipelineKey` string, string, required — The pipeline key

## Query parameters

- `filter` string, string — Accepts filter by `status` and `activePhaseId`. `status` can take a value of `completed` or `active`. `activePhaseId` takes a UUID and will filter results down to releases active on the specified phase. Providing `status equals completed` along with an `activePhaseId` filter will return an error as they are disjoint sets of data. The combination of `status equals active` and `activePhaseId` will return the same results as `activePhaseId` alone.
- `limit` integer — The maximum number of items to return. Defaults to 20.
- `offset` integer — Where to start in the list. Defaults to 0. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.

## Response `200`

Release progression collection

- ReleaseProgressionCollection
  - `activeCount` integer, required — The number of active releases
  - `completedCount` integer, required — The number of completed releases
  - `items` ReleaseProgression[], required — A list of details for each release, across all flags, for this release pipeline
    - `_createdAt` integer, required
    - `_completedAt` integer
    - `flagKey` string, required — The flag key
    - `activePhaseId` string — The ID of the currently active release phase
    - `_links` object, required — The location and content type of related resources
  - `phases` PhaseInfo[], required — A list of details for each phase, across all releases, for this release pipeline
    - `_id` string, required — The phase ID
    - `name` string, required — The release phase name
    - `releaseCount` integer, required — The number of active releases in this phase
  - `totalCount` integer, required — The total number of releases for this release pipeline
  - `_links` object, required — The location and content type of related resources

## Other responses

- `404` — Invalid resource identifier

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)