Get filtered dataset logs summary

POST

https://api.respan.ai/api/datasets/:dataset_id/logs/summary/

POST

/api/datasets/:dataset_id/logs/summary/

$ curl -X POST https://api.respan.ai/api/datasets/dataset_id/logs/summary/ \
>      -H "Authorization: Bearer <respanApiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "filters": {
>     "status_code": {
>       "operator": "eq",
>       "value": 200
>     }
>   }
> }'

1 {
2   "number_of_requests": 150,
3   "total_cost": 12.45,
4   "total_tokens": 50000,
5   "total_prompt_tokens": 30000,
6   "total_completion_tokens": 20000,
7   "avg_latency": 1.23,
8   "avg_tps": 45.2,
9   "avg_ttft": 0.8,
10   "scores": {
11     "550e8400-e29b-41d4-a716-446655440000": {
12       "evaluator_id": "550e8400-e29b-41d4-a716-446655440000",
13       "evaluator_slug": "accuracy",
14       "evaluator_name": "Accuracy Check",
15       "score_value_type": "numerical",
16       "avg_score": 4.2,
17       "true_count": null,
18       "false_count": null
19     }
20   }
21 }

Get aggregate usage metrics and evaluator score summaries for a filtered subset of dataset logs.

Authentication

AuthorizationBearer

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.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

dataset_idstringRequired

Dataset ID.

Request

This endpoint expects an object.

filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

Response

Filtered dataset log summary.

number_of_requestsinteger

total_costdouble

total_tokensinteger

total_prompt_tokensinteger

total_completion_tokensinteger

avg_latencydouble

avg_tpsdouble

avg_ttftdouble

scoresmap from strings to objects

Errors

401

Unauthorized Error

404

Not Found Error