---
title: "Changes to Get Holdout by Id"
method: GET
path: "/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts/id/{holdoutId}"
---

# Changes to Get Holdout by Id

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 5 revisions.

- **2026-02-28** `69c5c9aafe78` — 9 warning, 28 info
- **2025-07-08** `b2724c5174d1` — 9 warning

## Changes

- **2026-02-28** `69c5c9aafe78` — 9 warning, 28 info
  - added the new `not_started` enum value to the `baseExperiment/currentIteration/status` response property for the response status `200`
  - added the new `not_started` enum value to the `baseExperiment/draftIteration/status` response property for the response status `200`
  - added the new `not_started` enum value to the `baseExperiment/previousIterations/items/status` response property for the response status `200`
  - added the new `running` enum value to the `baseExperiment/currentIteration/status` response property for the response status `200`
  - added the new `running` enum value to the `baseExperiment/draftIteration/status` response property for the response status `200`
  - added the new `running` enum value to the `baseExperiment/previousIterations/items/status` response property for the response status `200`
  - added the new `stopped` enum value to the `baseExperiment/currentIteration/status` response property for the response status `200`
  - added the new `stopped` enum value to the `baseExperiment/draftIteration/status` response property for the response status `200`
  - added the new `stopped` enum value to the `baseExperiment/previousIterations/items/status` response property for the response status `200`
  - added the optional property `baseExperiment/currentIteration/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/metrics/items/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/primaryFunnel/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/primaryMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/primaryMetric/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/primarySingleMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/reallocationFrequencyMillis` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/secondaryMetrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/currentIteration/version` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/metrics/items/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/primaryFunnel/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/primaryMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/primaryMetric/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/primarySingleMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/reallocationFrequencyMillis` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/secondaryMetrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/draftIteration/version` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/metrics/items/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/primaryFunnel/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/primaryMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/primaryMetric/metrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/primarySingleMetric/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/reallocationFrequencyMillis` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/secondaryMetrics/items/eventKey` to the response with the `200` status
  - added the optional property `baseExperiment/previousIterations/items/version` to the response with the `200` status
  - added the optional property `baseExperiment/tags` to the response with the `200` status
- **2025-07-08** `b2724c5174d1` — 9 warning
  - added the new `guardrail` enum value to the `baseExperiment/currentIteration/metrics/items/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/currentIteration/primaryFunnel/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/currentIteration/primaryMetric/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/draftIteration/metrics/items/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/draftIteration/primaryFunnel/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/draftIteration/primaryMetric/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/previousIterations/items/metrics/items/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/previousIterations/items/primaryFunnel/kind` response property for the response status `200`
  - added the new `guardrail` enum value to the `baseExperiment/previousIterations/items/primaryMetric/kind` response property for the response status `200`

---

[Operation](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/docs/api/v2/projects/:projectKey/environments/:environmentKey/holdouts/id/:holdoutId/get.md) · [API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [Page](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/changes/api/v2/projects/:projectKey/environments/:environmentKey/holdouts/id/:holdoutId/get)