---
title: "Summarize Dataset Logs Filtered"
method: POST
path: "/api/datasets/{dataset_id}/logs/summary/"
tags: ["datasets"]
---

# Summarize Dataset Logs Filtered

`POST /api/datasets/{dataset_id}/logs/summary/`

Get summary statistics for a filtered subset of dataset logs.

## Path parameters

- `dataset_id` string, required

## Headers

- `Authorization` string, required

## Request body

- DatasetFilterRequestRequest — Shared request body for all dataset POST-for-filtering endpoints.
  - `filters` object — Filter parameters keyed by metric name.

## Response `200`

- DatasetLogsSummaryResponse
  - `number_of_requests` integer, required
  - `total_cost` number, double, required
  - `total_tokens` integer, required
  - `total_prompt_tokens` integer, required
  - `total_completion_tokens` integer, required
  - `avg_latency` number, double, required
  - `avg_tps` number, double, required
  - `avg_ttft` number, double, required
  - `has_output` boolean, required
  - `scores` object, required

## Changes

- **2026-07-31** `c26d550029f8` — 2 breaking, 9 warning, 3 info
  - the `filters/additionalProperties/` request property type/format changed from `object`/`` to ``/``
  - the `scores/additionalProperties/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `filters/additionalProperties/operator`
  - removed the request property `filters/additionalProperties/value`
  - …10 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/datasets/:dataset_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/c26d550029f8/schema)