Get evaluation scores summary

Returns evaluation scores aggregated over the time range.

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Query parameters

summary_typeenumOptionalDefaults to all

Preset time range. Use this or explicit start_time / end_time.

datedateOptional

Base date used with summary_type presets.

start_timedatetimeOptional

Optional explicit ISO start time.

end_timedatetimeOptional

Optional explicit ISO end time.

time_tickenumOptionalDefaults to hour

Bucket granularity for time-series responses.

Allowed values:

timezone_offsetdoubleOptionalDefaults to 0

Timezone offset, in hours, used when resolving preset ranges.

Response

Successful response.

$	curl -X POST https://api.respan.ai/api/dashboard/eval-results/summary/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"average_score": 87.5,
3	"total_evaluations": 1240,
4	"passed_evaluations": 1100,
5	"failed_evaluations": 140,
6	"evaluation_breakdown": {
7	"accuracy": 89.2,
8	"precision": 85.7,
9	"recall": 88.1,
10	"f1_score": 86.9
11	},
12	"time_range": {
13	"start_time": "2024-05-01T00:00:00Z",
14	"end_time": "2024-05-31T23:59:59Z"
15	},
16	"summary_type": "monthly"
17	}