---
title: "Get all holdouts"
method: GET
path: "/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts"
tags: ["Holdouts (beta)"]
---

# Get all holdouts

`GET /api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts`

## Path parameters

- `projectKey` string, string, required — The project key
- `environmentKey` string, string, required — The environment key

## Query parameters

- `limit` integer — The number of holdouts to return in the response. Defaults to 20
- `offset` integer — Where to start in the list. 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`

All Holdouts response

- HoldoutsCollectionRep
  - `items` SimpleHoldoutRep[]
    - `_id` string
    - `key` string
    - `name` string
    - `status` string
    - `createdAt` integer
    - `updatedAt` integer
    - `experiments` RelatedExperimentRep[]
      - `key` string
      - `name` string
      - `environment` string
  - `_links` object — The location and content type of related resources
  - `total_count` integer — The total number of holdouts in this project and environment.

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `429` — Rate limited

---

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