v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
datasets

Summarize Dataset Logs Filtered

Get summary statistics for a filtered subset of dataset logs.

post/api/datasets/{dataset_id}/logs/summary/

Path parameters

dataset_idstring required

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

filtersobject

Filter parameters keyed by metric name.

Response

number_of_requestsinteger required
total_costnumber double required
total_tokensinteger required
total_prompt_tokensinteger required
total_completion_tokensinteger required
avg_latencynumber double required
avg_tpsnumber double required
avg_ttftnumber double required
has_outputboolean required
scoresobject required