---
title: "Get a release policy by key"
method: GET
path: "/api/v2/projects/{projectKey}/release-policies/{policyKey}"
tags: ["Release policies (beta)"]
---

# Get a release policy by key

`GET /api/v2/projects/{projectKey}/release-policies/{policyKey}`

Retrieve a single release policy by its key for the specified project.

## Path parameters

- `projectKey` string, required
- `policyKey` string, required

## Headers

- `LD-API-Version` 'beta', required

## Response `200`

Release policy found

- ReleasePolicy
  - `_access` ReleasePoliciesAccessRep
    - `denied` ReleasePoliciesAccessDenied[], required
      - `action` string, required
      - `reason` ReleasePoliciesAccessDeniedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
    - `allowed` ReleasePoliciesAccessAllowedRep[], required
      - `action` string, required
      - `reason` ReleasePoliciesAccessAllowedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
  - `_id` string, required — The unique identifier of the release policy
  - `scope` ReleasePolicyScope
    - `environmentKeys` string[] — List of environment keys this policy applies to
    - `flagTagKeys` string[] — List of flag tag keys this policy applies to
  - `rank` integer, required — The rank/priority of the release policy
  - `releaseMethod` 'guarded-release' | 'progressive-release', required — The release method for this policy
  - `guardedReleaseConfig` GuardedReleaseConfig — Configuration for guarded releases
    - `rolloutContextKindKey` string — Context kind key to use as the randomization unit for the rollout
    - `minSampleSize` integer — The minimum number of samples required to make a decision
    - `rollbackOnRegression` boolean — Whether to roll back on regression
    - `metricKeys` string[] — List of metric keys
    - `metricGroupKeys` string[] — List of metric group keys
    - `stages` ReleasePolicyStage[] — List of stages
      - `allocation` integer, required
      - `durationMillis` integer, required
  - `progressiveReleaseConfig` ProgressiveReleaseConfig — Configuration for progressive releases
    - `rolloutContextKindKey` string — Context kind key to use as the randomization unit for the rollout
    - `stages` ReleasePolicyStage[] — List of stages
      - `allocation` integer, required
      - `durationMillis` integer, required
  - `name` string, required — The name of the release policy
  - `key` string, required — The human-readable key of the release policy

## Other responses

- `400` — Bad request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

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