Evaluation

List Test Runs

Retrieves a paginated list of test runs for the authorized project. Results can be filtered and sorted by status, dates, conversational (multi-turn) or metrics. Pagination is controlled with page and pageSize. Filtering and sorting options include status, multiTurn, sortField, and ascending.

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number (must be a positive integer, default is 1).

pageSizeintegerOptional1-100Defaults to 25

Number of items per page (max 100, default is 25).

statusenumOptional
Filter test runs by status.
Allowed values:
multiTurnenumOptional

Filter for conversational (multi-turn) test runs only (“true” or “false”).

Allowed values:
sortByenumOptionalDefaults to createdAt

Field to sort results by (“createdAt” or “runDuration”).

Allowed values:
ascendingenumOptional

This determines if the field specified in sortBy should be in ascending order. Defaults to false.

Allowed values:
startstringOptionalformat: "datetime"

ISO 8601 start datetime filter (e.g. “2025-12-31T23:59:59Z”).

endstringOptionalformat: "datetime"

ISO 8601 end datetime filter (e.g. “2025-12-31T23:59:59Z”).

Response

A paginated list of test runs and total count.
successboolean
dataobject