Sign in
experiments

Filter experiment trace summary

Get aggregate workflow metrics and evaluator score summaries for traces matching a POST filter payload.

post/api/v2/experiments/{experiment_id}/logs/summary/

Path parameters

experiment_idstring required

Experiment ID returned as id in experiment responses.

Query parameters

start_timestring date-time

Filter results at or after this timestamp.

end_timestring date-time

Filter results before this timestamp.

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

filtersApiV2ExperimentsExperimentIdLogsSummaryPostRequestBodyContentApplicationJsonSchemaFilters

Filter criteria using the standard Respan filter format.

is_exportingboolean

Reserved for dashboard exports.

Response

Experiment trace summary.

number_of_requestsinteger required

Total number of traces matching the filters.

total_costnumber double required

Sum of request costs in USD.

total_tokensinteger required
total_prompt_tokensinteger
total_completion_tokensinteger
avg_latencynumber double

Average latency in seconds.

avg_tpsnumber double

Average output tokens per second.

avg_ttftnumber double

Average time to first token in seconds.

scoresobject required

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

Changes