---
title: "Filter experiments"
method: POST
path: "/api/v2/experiments/list/"
tags: ["experiments"]
---

# Filter experiments

`POST /api/v2/experiments/list/`

List experiments using POST-for-filtering.

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` string

## Headers

- `Authorization` string, required

## Request body

- object
  - `filters` ApiV2ExperimentsListPostRequestBodyContentApplicationJsonSchemaFilters — Filter criteria using the standard Respan filter format.
  - `is_exporting` boolean — Reserved for dashboard exports.

## Response `200`

Paginated filtered list of experiments.

- ExperimentsListExperimentsResponse200
  - `count` integer, required — Total number of matching results.
  - `next` string, nullable — URL for the next page, if any.
  - `previous` string, nullable — URL for the previous page, if any.
  - `current_filters` ApiV2ExperimentsListPostResponsesContentApplicationJsonSchemaCurrentFilters — Normalized filters applied to this request.
  - `results` ApiV2ExperimentsListPostResponsesContentApplicationJsonSchemaResultsItems[], required
    - `id` string, required — Experiment ID.
    - `name` string, required — Experiment name.
    - `description` string, nullable — Experiment description.
    - `dataset` string, nullable — Dataset ID associated with the experiment.
    - `dataset_id` string, nullable — Dataset ID associated with the experiment.
    - `dataset_name` string, nullable — Dataset name, when available.
    - `workflow_count` integer — Number of workflow steps.
    - `status` string, required — Experiment execution status.
    - `progress` number, double — Execution progress percentage.
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `tags` object[] — Tags attached to the experiment.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing or invalid authentication

---

[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/revisions/4e064cf81dae/schema)