Swagger Petstore - OpenAPI 3.0
GET/evals/{eval_id}/runs

List evaluation runs

Lists all runs for a given evaluation with optional filtering and pagination. Use status to filter by run state, order to control sort direction, and after with limit for cursor-based pagination. Results are ordered by creation timestamp.

5 parameters
eval_idstringrequired
The unique identifier of the evaluation whose runs to retrieve.
afterstringoptional
Cursor identifier from the previous response's `last_id` field for pagination. Omit for the first page.
limitintegeroptional
Number of runs to retrieve per page. Defaults to 20 if omitted.
Default:20
orderstringoptional
Sort order by creation timestamp: asc for ascending or desc for descending. Defaults to asc if omitted.
Allowed:ascdescDefault:asc
statusstringoptional
Filter runs by status: queued, in_progress, completed, canceled, or failed. Omit to retrieve runs of all statuses.
Allowed:queuedin_progresscompletedcanceledfailed

2 status codes
200Returns a paginated list of evaluation run objects with metadata including first and last identifiers and a flag indicating whether more results are available.
objectstringrequired
The type of this object. It is always set to "list".
Allowed:listDefault:list
dataarray<EvalRun>required
An array of eval run objects.
first_idstringrequired
The identifier of the first eval run in the data array.
last_idstringrequired
The identifier of the last eval run in the data array.
has_morebooleanrequired
Indicates whether there are more evals available.
429Returned when the request rate limit is exceeded.
errorobjectrequired

Error handling

eval_id must identify an existing evaluation. status must be one of: queued, in_progress, completed, canceled, or failed if provided. order must be asc or desc. A 429 is returned when the request rate limit is exceeded.