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

# Filter experiments summary

`POST /api/v2/experiments/summary/`

Return the number of experiments matching a POST filter payload.

## Headers

- `Authorization` string, required

## Request body

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

## Response `200`

Experiment summary.

- ExperimentsFilterExperimentsSummaryResponse200
  - `total_count` integer, required — Number of experiments matching the filters.

## Other responses

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

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 1 breaking, 2 warning, 2 info
  - added the new required request property `total_count`
  - removed the request property `filters`
  - removed the request property `is_exporting`
  - removed the non-success response with the status `400`
  - …1 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/v2/experiments/summary/post.md)

---

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