4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
evaluators

List evaluators with filters

List evaluators using POST-for-filtering. The backend returns only the current draft/latest row for each evaluator and includes filter metadata for dashboard clients.

post/api/evaluators/list/

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of results to return per page. Maximum 100.

sort_bystring

Field to sort by. Prefix with - for descending order.

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

filtersApiEvaluatorsListPostRequestBodyContentApplicationJsonSchemaFilters

Filter criteria using the standard Respan filter format.

is_exportingboolean

Reserved for dashboard exports.

Response

Paginated filtered evaluator list.

countinteger required

Number of resources returned on this page.

nextstring nullable

URL for the next page, if any.

previousstring nullable

URL for the previous page, if any.

current_filtersApiEvaluatorsListPostResponsesContentApplicationJsonSchemaCurrentFilters

Normalized filters applied to this request.

filters_dataobject

Available filter options for evaluator list UI clients.