Sample - OpenAI API
GET/evals

List project evaluations

Lists evaluations for a project in a paginated result set. Use after to continue from a previous page, limit to control page size, and order with order_by to control sorting. The response includes evaluation records, boundary identifiers, and whether more evaluations are available.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 parameters
afterstringoptional
The identifier of the last evaluation from the previous page, used to continue pagination.
limitintegeroptional
The number of evaluations to retrieve. Defaults to 20 when omitted.
Default:20
orderstringoptional
The timestamp sort order: `asc` for ascending or `desc` for descending. Defaults to `asc` when omitted.
Allowed:ascdescDefault:asc
order_bystringoptional
The timestamp used for sorting: `created_at` or `updated_at`. Defaults to `created_at` when omitted.
Allowed:created_atupdated_atDefault:created_at

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

Error handling

A 429 is returned when the request rate exceeds the allowed limit. order must be asc or desc, and order_by must be created_at or updated_at; limit defaults to 20 when omitted.