---
title: "List release policies"
method: GET
path: "/api/v2/projects/{projectKey}/release-policies"
tags: ["Release policies (beta)"]
---

# List release policies

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

Get a list of release policies for the specified project with optional filtering.

## Path parameters

- `projectKey` string, required

## Query parameters

- `excludeDefault` boolean

## Headers

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

## Response `200`

List of release policies

- ReleasePoliciesResponse
  - `items` ReleasePolicy[], required — List of release policies
    - `_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
  - `totalCount` integer, required — Total number of release policies

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