For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTCreate a dataset
      • POSTList datasets
      • GETRetrieve a dataset
      • PATCHUpdate a dataset
      • DELDelete a dataset
      • POSTCreate a dataset log
      • POSTList dataset logs
      • GETRetrieve a dataset log
      • PATCHUpdate a dataset log
      • DELDelete a dataset log
      • POSTBulk create dataset logs
      • POSTRun evaluators on a dataset
      • GETList dataset evaluation runs
      • PUTReplace a dataset log
      • POSTImport existing logs into a dataset
      • DELRemove logs from a dataset
      • GETGet dataset logs summary
      • POSTGet filtered dataset logs summary
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceDatasets

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 sk_live_xxxxx" \
>     -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.
Was this page helpful?
Previous

Create a testset

Next
Built with

Path parameters

dataset_idstringRequired
Dataset ID.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

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