---
title: "Retrieve Running Experiments"
method: GET
path: "/v2/cdn/experiments"
tags: ["Experiments"]
---

# Retrieve Running Experiments

`GET /v2/cdn/experiments`

## Request

- Base URL: `https://api.storyblok.com`
- URL: `https://api.storyblok.com/v2/cdn/experiments`
- Auth: API key in query parameter `token`
- TypeScript: <https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/docs/v2/cdn/experiments/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all running experiments from your Storyblok space.

## Query parameters

- `cv` integer
- `token` string, required

## Response `200`

Running experiments returned

- object
  - `experiments` Experiment[], required: The experiments object.
    - `id` integer, required: Numeric ID of the experiment.
    - `name` string, required: Internal name (lowercase letters, numbers, and underscores).
    - `display_name` string, required: Human-readable display name.
    - `story_ids` integer[], required: IDs of [stories](https://www.storyblok.com/docs/api/content-delivery/v2/stories/retrieve-a-single-story) assigned to the experiment.
    - `variants` ExperimentVariant[], required: Variants belonging to the experiment.
      - `name` string, required: Internal name (lowercase letters, numbers, and underscores).
      - `display_name` string, required: Human-readable display name.
      - `public_id` string, required: Public identifier for stable bucketing.
      - `weight` integer, required: Traffic weight percentage (0-100).
      - `is_control` boolean, required: Returns `true` if the variant is the control.
      - `story_mappings` object[], required: Mappings between original stories and their variant copies.
        - `original_story_id` integer, required: Numeric ID of the original [story](https://www.storyblok.com/docs/api/content-delivery/v2/stories/retrieve-a-single-story).
        - `original_slug` string, nullable, required: Slug of the original story.
        - `variant_story_id` integer, nullable, required: Numeric ID of the variant story copy.
        - `variant_slug` string, nullable, required: Slug of the variant story copy.
    - `stories` object[], required: Stories assigned to this experiment. Same stories as story_ids, with their full slug. The full_slug is the default-language slug; translated slugs are not applied.
      - `id` integer, required: Numeric ID of the story.
      - `full_slug` string, required: The story’s full slug, including parent folder and language paths.
  - `cv` integer, nullable: Cached version Unix timestamp. Learn more in the [Caching concept](https://www.storyblok.com/docs/concepts/caching).

## Other responses

- `401`: Unauthorized
- `429`: Rate limit reached

---

[API](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api.md) - [All operations](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/revisions/5b75af03f24f?raw)