Skip to main content
GET
Requires version 1.1.12 or later of the Archetype platform.

Overview

This endpoint returns a cursor-paginated page of evals, newest first. Each entry is a full eval, with the same fields Get Eval returns. Filter by lifecycle status, by the blueprint being evaluated, or search by name and ID.

Request

integer
default:"100"
Page size. Minimum 1, maximum 1000.
string
Forward cursor: return evals older than the one with this ID. Pass the next_cursor of the previous page (or the id of its last eval) to fetch the next page.
This parameter is mutually exclusive with before; do not include both.
string
Backward cursor: return evals newer than the one with this ID. Pass the ID of the first eval of the current page to walk back.
This parameter is mutually exclusive with after; do not include both.
string
Filter to a single lifecycle status (e.g. pending, completed). Omit for all statuses. One of pending, running, completed, failed, cancelled.
string
Case-insensitive substring match over the eval name and ID. Omit for no search filter.
To search for an exact blueprint ID, use the blueprint_id parameter instead.
string
Restrict to evals of this blueprint (blp_ ID, exact match). Unlike query, this requires a full match to the specified blueprint ID.

Response

array
required
The page, newest first. Each entry is an eval, in the shape Get Eval returns. Each entry carries the full eval. If the eval has completed, it includes the metrics_report, so you don’t need to make another request to show scores.
Results are ordered newest first in both cursor directions, so render data as returned.
boolean
required
true when more results exist beyond this page in the direction of travel.
string
Cursor for the next page in the same direction; pass it as after when paging forward, or as before when you supplied before. null when has_more is false.