---
title: "Filter experiment trace summary"
method: POST
path: "/api/v2/experiments/{experiment_id}/logs/summary/"
tags: ["experiments"]
---

# Filter experiment trace summary

`POST /api/v2/experiments/{experiment_id}/logs/summary/`

Get aggregate workflow metrics and evaluator score summaries for traces matching a POST filter payload.

## Path parameters

- `experiment_id` string, required

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time

## Headers

- `Authorization` string, required

## Request body

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

## Response `200`

Experiment trace summary.

- ExperimentsFilterExperimentSpansSummaryResponse200
  - `number_of_requests` integer, required — Total number of traces matching the filters.
  - `total_cost` number, double, required — Sum of request costs in USD.
  - `total_tokens` integer, required
  - `total_prompt_tokens` integer
  - `total_completion_tokens` integer
  - `avg_latency` number, double — Average latency in seconds.
  - `avg_tps` number, double — Average output tokens per second.
  - `avg_ttft` number, double — Average time to first token in seconds.
  - `scores` object, required — Scores keyed by evaluator ID or slug. Each value includes evaluator metadata and the score value field matching `score_value_type`.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found
- `413` — The query exceeded a memory or execution-time resource limit.

## Changes

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

- **2026-07-31** `c26d550029f8` — 5 breaking, 7 warning, 3 info
  - removed the request body
  - removed the required property `number_of_requests` from the response with the `200` status
  - removed the required property `scores` from the response with the `200` status
  - removed the required property `total_cost` from the response with the `200` status
  - …11 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/v2/experiments/:experiment_id/logs/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)