OpenAI API (unofficial showcase)
GET/evals/{eval_id}/runs

List runs for an evaluation

Lists runs for a specified evaluation, with optional cursor pagination, ordering, and status filtering. Use after to continue from a run in a previous response, and use status to limit results to runs in a particular state.

5 parameters
eval_idstringrequired
The identifier of the evaluation whose runs to list.
afterstringoptional
The identifier of the last run from the previous page; omit it to start from the beginning.
limitintegeroptional
The number of runs to retrieve. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by timestamp: `asc` or `desc`. Defaults to `asc` when omitted.
Allowed:ascdescDefault:asc
statusstringoptional
Filter runs by status: `queued`, `in_progress`, `completed`, `canceled`, or `failed`.
Allowed:queuedin_progresscompletedcanceledfailed

4 status codes
200Returns a list of evaluation run objects with pagination identifiers and a `has_more` flag.
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.
400Returned when the run list parameters are invalid.
errorobjectrequired
404Returned when the evaluation or the run specified by `after` is not found.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 400 is returned when run list parameters are invalid. A 404 is returned when the evaluation or the run specified by after is not found. A 429 is returned when the request exceeds a rate limit. order must be asc or desc, and status must be queued, in_progress, completed, canceled, or failed.