---
title: "Get release for flag"
method: GET
path: "/api/v2/flags/{projectKey}/{flagKey}/release"
tags: ["Releases (beta)"]
---

# Get release for flag

`GET /api/v2/flags/{projectKey}/{flagKey}/release`

Get currently active release for a flag

## Path parameters

- `projectKey` string, string, required — The project key
- `flagKey` string, string, required — The flag key

## Response `200`

Release response

- Release
  - `_links` object — The location and content type of related resources
  - `name` string, required — The release pipeline name
  - `releasePipelineKey` string, required — The release pipeline key
  - `releasePipelineDescription` string, required — The release pipeline description
  - `phases` ReleasePhase[], required — An ordered list of the release pipeline phases
    - `_id` string, required — The phase ID
    - `_name` string, required — The release phase name
    - `complete` boolean, required — Whether this phase is complete
    - `_creationDate` integer, required
    - `_completionDate` integer
    - `_completedBy` CompletedBy
      - `member` MemberSummary
        - `_links` object, required — The location and content type of related resources
        - `_id` string, required — The member's ID
        - `firstName` string — The member's first name
        - `lastName` string — The member's last name
        - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
        - `email` string, required — The member's email address
      - `token` TokenSummary
        - `_links` object
        - `_id` string
        - `name` string — The name of the token
        - `ending` string — The last few characters of the token
        - `serviceToken` boolean — Whether this is a service token
    - `_audiences` ReleaseAudience[], required — A logical grouping of one or more environments that share attributes for rolling out changes
      - `_id` string, required — The audience ID
      - `_links` object — The location and content type of related resources
      - `environment` EnvironmentSummary
        - `_links` object, required — The location and content type of related resources
        - `key` string, required — A project-unique key for the environment
        - `name` string, required — A human-friendly name for the environment
        - `color` string, required — The color used to indicate this environment in the UI
      - `name` string, required — The release phase name
      - `configuration` AudienceConfiguration
        - `releaseStrategy` string, required
        - `requireApproval` boolean, required — Whether or not the audience requires approval
        - `notifyMemberIds` string[] — An array of member IDs. These members are notified to review the approval request.
        - `notifyTeamKeys` string[] — An array of team keys. The members of these teams are notified to review the approval request.
        - `releaseGuardianConfiguration` ReleaseGuardianConfiguration
          - `monitoringWindowMilliseconds` integer, required — The monitoring window in milliseconds
          - `rolloutWeight` integer, required — The rollout weight percentage
          - `rollbackOnRegression` boolean, required — Whether or not to roll back on regression
          - `randomizationUnit` string — The randomization unit for the measured rollout
      - `segmentKeys` string[] — A list of segment keys
      - `status` string
      - `_ruleIds` string[] — The rules IDs added or updated by this audience
    - `status` string
    - `started` boolean — Whether or not this phase has started
    - `_startedDate` integer
    - `configuration` PhaseConfiguration
  - `_version` integer, required — The release version
  - `_releaseVariationId` string — The chosen release variation ID to use across all phases of a release
  - `_canceledAt` integer

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