---
title: "GET /api/v1/environments/{environment_api_key}/experiments/"
method: GET
path: "/api/v1/environments/{environment_api_key}/experiments/"
tags: ["mcp"]
---

# GET /api/v1/environments/{environment_api_key}/experiments/

`GET /api/v1/environments/{environment_api_key}/experiments/`

(Beta) Lists experiments for an environment. Supports filtering by status and searching by experiment or feature name.

## Path parameters

- `environment_api_key` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `q` string
- `status` string

## Response `200`

- PaginatedExperimentListList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ExperimentList[], required
    - `id` integer
    - `feature` ExperimentFeature
      - `id` integer
      - `name` string
      - `type` 'STANDARD' | 'MULTIVARIATE' — * `STANDARD` - STANDARD * `MULTIVARIATE` - MULTIVARIATE
      - `initial_value` string, nullable
      - `multivariate_options` object[]
    - `name` string, required
    - `hypothesis` string, required
    - `status` 'created' | 'running' | 'paused' | 'completed' — * `created` - Created * `running` - Running * `paused` - Paused * `completed` - Completed
    - `metrics` ExperimentMetric[]
      - `id` integer
      - `metric` integer, required
      - `metric_name` string
      - `aggregation` string
      - `direction` 'up' | 'down' | 'informational' — * `up` - Higher is better * `down` - Lower is better * `informational` - Informational only
      - `expected_direction` 'increase' | 'decrease' | 'not_increase' | 'not_decrease', required — * `increase` - Increase * `decrease` - Decrease * `not_increase` - Should not increase * `not_decrease` - Should not decrease
      - `created_at` string, date-time
    - `experiment_rollout` ExperimentRollout
      - `enabled` boolean, required
      - `rollout_percentage` number, double, required
      - `feature_state_value` FeatureValue, required
        - `type` 'integer' | 'string' | 'boolean', required — * `integer` - integer * `string` - string * `boolean` - boolean
        - `value` string, required
      - `multivariate_feature_state_values` MultivariateValue[]
        - `multivariate_feature_option` integer, required
        - `percentage_allocation` number, double, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `started_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable

## Changes

> 11 revisions in range; 4 could not be searched.

- **2026-07-27** `ff1974a10373` — 1 info
  - added the optional property `results/items/metrics/items/direction` to the response with the `200` status

[Change history](https://skmtc.dev/flagsmith/apis/flagsmith-api/changes/api/v1/environments/:environment_api_key/experiments/get.md)

---

[API](https://skmtc.dev/flagsmith/apis/flagsmith-api.md) · [All operations](https://skmtc.dev/flagsmith/apis/flagsmith-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flagsmith/flagsmith-api/revisions/5a8154d05269/schema)