evals

List Evaluations

List your evaluations, newest first, scoped to the environment of the API key you call with.

Each row carries the status, progress and per-configuration scorecards, so a dashboard or agent can show where every evaluation stands without fetching each one. Per-case results and stored answers stay on GET /v3/evals/{eval_id}.

Page with cursor until next_cursor is null; there is no total count. Evaluations still running are settled against their job before the page returns, up to a few per page, so a finished run stops reading as running.

get/v3/evals

Query parameters

collectionstring nullable

Only evaluations against this collection.

statusstring nullable

Filter by status: pending, running, completed, completed_with_errors or failed.

limitinteger

Rows per page (1-100).

cursorstring nullable

Continue from a previous page's next_cursor.

Response

Successful Response

countinteger required

Rows on this page. There is no total; page until next_cursor is null.

next_cursorstring nullable

Pass as cursor to continue. Null on the last page.

Changes

Changed in 2 of the 13 revisions of this API.3117

Sep 24, 202661a9364ad0423116See the full diff
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 17, 20266ed36830de711See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history