List dataset evaluation runs

GET

https://api.respan.ai/api/datasets/:dataset_id/eval-reports/list/

List evaluation runs that were created for a dataset.

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.

Path parameters

dataset_idstringRequired

Dataset ID.

Query parameters

pageintegerOptionalDefaults to 1

Page number.

page_sizeintegerOptional<=100Defaults to 25

Results per page. Maximum is 100.

Response

Paginated list of dataset evaluation runs.

countinteger

nextstring or null

previousstring or null

total_countinteger

current_filtersmap from strings to objects

Platform-standard filters keyed by field name.

filters_dataobject

resultslist of objects

Errors

401

Unauthorized Error

1	{
2	"count": 1,
3	"next": null,
4	"previous": null,
5	"total_count": 1,
6	"current_filters": {},
7	"filters_data": {},
8	"results": [
9	{
10	"task_id": "task_01J6ABCDEF",
11	"name": "Run evaluator accuracy on dataset Support Conversations - July",
12	"dataset_id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
13	"evaluator_slug": "accuracy",
14	"status": "completed",
15	"started_at": "2025-12-09T10:05:00Z",
16	"completed_at": "2025-12-09T10:07:00Z",
17	"error_message": "",
18	"evaluated_logs_count": 250,
19	"score": 0.91
20	}
21	]
22	}

$	curl https://api.respan.ai/api/datasets/dataset_id/eval-reports/list/ \
>	-H "Authorization: Bearer <respanApiKey>"