---
title: "Get Experiment by ID."
method: GET
path: "/failure-flags/experiments/{id}"
tags: ["failure-flags.experiments"]
---

# Get Experiment by ID.

`GET /failure-flags/experiments/{id}`

Requires the privilege [`EXPERIMENTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `id` string, required

## Query parameters

- `teamId` string, required

## Response `200`

Get an Experiment by team and ID

- Experiment
  - `id` string
  - `teamId` string
  - `name` string, required
  - `staticTargeting` boolean
  - `app` Selector, required
    - `name` string, required
    - `labels` object, required — Label selectors for matching resources
    - `runtimeLabels` object — Labels for matching resources resolved at runtime (e.g., "zones" are resolved and added to the label "ips")
  - `flag` Selector, required
    - `name` string, required
    - `labels` object, required — Label selectors for matching resources
    - `runtimeLabels` object — Labels for matching resources resolved at runtime (e.g., "zones" are resolved and added to the label "ips")
  - `appInstanceSampling` TargetSampling
    - `type` string, required
  - `duration` string, required — The duration expressed as a variant of ISO 8601 with the following simplifications: 1. no leading 'PT' (eg. 5m or 10h) 2. valid time units are exclusively: m, h, d, s
  - `rate` number, float
  - `effect` object
  - `recentHistory` ExperimentRunSummary[]
    - `startTime` string, date-time
    - `stopTime` string, date-time
    - `impacts` integer
    - `deliveries` integer
  - `createdAt` string, date-time
  - `startTime` string, date-time
  - `currentRun` ExperimentRun
    - `startTime` string, date-time
    - `impactSeries` SeriesMinute[]
      - `minute` integer
      - `count` integer
    - `deliverySeries` SeriesMinute[]
      - `minute` integer
      - `count` integer
    - `triggerSource` 'MANUAL' | 'RUN_ALL' | 'SCHEDULED' | 'RECURRING_SCHEDULE'
    - `triggeredBy` string
  - `protected` boolean

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: EXPERIMENTS_READ
- `404` — Not found

---

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