---
title: "Api V 2 Experiments List List"
method: GET
path: "/api/v2/experiments/list/"
tags: ["experiments"]
---

# Api V 2 Experiments List List

`GET /api/v2/experiments/list/`

GET: List experiments with filters
POST: List experiments with filters (same as GET, but accepts filter payload in body)

Special endpoint for filtered listing. The main endpoint `/experiments/`
handles GET (list) + POST (create) operations.

**Authentication:**
- Supports both JWT (internal) and API Key (public) authentication

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

- PaginatedExperimentV2ListList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `total_count` integer
  - `current_filters` FilterParamDictPydantic — Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters. Each key is a metric name (str), and each value can be: - A single MetricFilterParamPydantic (one condition) - A List[MetricFilterParamPydantic] (multiple conditions for same metric) - A FilterBundlePydantic (nested filter bundle with connector) Note: Uses extra="allow" for dynamic metric name fields. The __pydantic_extra__ annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.
  - `filters_data` PaginatedExperimentV2ListListFiltersData
  - `results` ExperimentV2List[], required
    - `id` string
    - `name` string
    - `dataset` string, nullable
    - `dataset_name` string, nullable, required
    - `model` string, nullable, required
    - `workflow_count` integer
    - `status` 'draft' | 'pending' | 'paused' | 'running' | 'waiting_for_annotations' | 'completed' | 'failed' — * `draft` - Draft * `pending` - Pending * `paused` - Paused * `running` - Running * `waiting_for_annotations` - Waiting For Annotations * `completed` - Completed * `failed` - Failed
    - `progress` number, double
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `tags` GenericTagDisplay[], required
      - `id` string, required
      - `name` string, required
      - `color` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `description` string
    - `is_starred` boolean
    - `prompt_name` string, nullable, required
    - `evaluator_names` string[], required
    - `evaluator_scores` object[], required

---

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