API ReferenceDatasets

List dataset evaluation runs

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, 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.

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

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.
countintegerOptional
nextstring or nullOptional
previousstring or nullOptional
total_countintegerOptional
current_filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

filters_dataobjectOptional
resultslist of objectsOptional

Errors

401
Unauthorized Error