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 an experiment
      • POSTFilter experiments
      • GETRetrieve an experiment
      • DELDelete an experiment
      • GETList or export experiment traces
      • POSTFilter experiment traces
      • GETRetrieve an experiment trace
      • PATCHResume a wait workflow trace
      • GETGet experiment trace summary
      • GETList experiments
      • GETList experiments with filters
      • GETGet experiments summary
      • POSTFilter experiments summary
      • PUTReplace an experiment
      • PATCHUpdate an experiment
      • POSTFilter experiment trace summary
      • GETGet experiment score histogram
      • POSTGet experiment score histogram with filters
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceExperiments

Get experiment trace summary

GET
https://api.respan.ai/api/v2/experiments/:experiment_id/logs/summary/
GET
/api/v2/experiments/:experiment_id/logs/summary/
$curl https://api.respan.ai/api/v2/experiments/experiment_id/logs/summary/ \
>     -H "Authorization: Bearer sk_live_xxxxx"
1{
2  "number_of_requests": 150,
3  "total_cost": 12.45,
4  "total_tokens": 50000,
5  "scores": {},
6  "total_prompt_tokens": 30000,
7  "total_completion_tokens": 20000,
8  "avg_latency": 1.23,
9  "avg_tps": 45.2,
10  "avg_ttft": 0.8
11}
Get aggregate workflow metrics and evaluator score summaries for experiment traces.
Was this page helpful?
Previous

List experiments

Next
Built with

Path parameters

experiment_idstringRequired

Experiment ID returned as id in experiment responses.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY for API key auth or Bearer <JWT> for dashboard auth.

Query parameters

start_timedatetimeOptional
Filter results at or after this timestamp.
end_timedatetimeOptional
Filter results before this timestamp.

Response

Experiment trace summary.
number_of_requestsinteger
Total number of traces matching the filters.
total_costdouble
Sum of request costs in USD.
total_tokensinteger
scoresmap from strings to objects

Scores keyed by evaluator ID or slug. Each value includes evaluator metadata and the score value field matching score_value_type.

total_prompt_tokensinteger
total_completion_tokensinteger
avg_latencydouble
Average latency in seconds.
avg_tpsdouble
Average output tokens per second.
avg_ttftdouble
Average time to first token in seconds.

Errors

401
Unauthorized Error
404
Not Found Error