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 by default. Use sort and order to rank them by creation time, name, or score instead. Each entry is an eval, with the same fields Get Eval returns, except that its examples array is always empty. Filter by lifecycle status, by the blueprint being evaluated, or by project, or search by name and ID. Without a project filter, the page holds the evals outside projects and those of every project you can see.
Real-world evals inline hundreds of examples each, and loading them for a list page would pull tens of MB per request. To see an eval’s examples, fetch it with Get Eval.
after and before are opaque cursors that snapshot the sort key of the eval at the edge of a page. Passing both, passing a malformed one, or replaying a cursor under a different sort than the one it was minted for returns HTTP status 400.

Request

integer
default:"100"
Page size. Minimum 1, maximum 1000.
string
Forward cursor: return the evals ranked after the edge of the previous page in the current sort order. Pass the next_cursor of the previous page to fetch the next page. Valid only under the sort it was minted for.
This parameter is mutually exclusive with before; do not include both.
string
Backward cursor: return the evals ranked before the edge of the current page in the current sort order. Pass the prev_cursor 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.
string
Filter by project. Omitted: the evals outside projects and those of every project you can see. A project’s prj_ id: that project’s evals only (404 when it does not exist or you cannot see it). none: lists evals outside any project. v2.0.0+
string
default:"created_at"
Sort field: created_at (default) ranks evals by creation, name alphabetically (case-sensitive), and score by the primary metric value (metrics_report.primary.value). Evals with no value for the active sort, such as unscored evals under score, are placed last in both directions. A cursor is only valid under the sort it was minted for; replaying it with a different sort is rejected with HTTP status code 400. v1.1.13+
string
Sort direction: asc or desc. Defaults per field: desc for created_at and score, asc for name. Keep it constant while paging with a cursor. v1.1.13+
boolean
default:"false"
When true, the response includes total. Off by default because it costs an extra count per request. v2.0.1+

Response

array
required
The page, ordered by the active sort and order (newest first by default). Each entry is an eval, in the shape Get Eval returns. If the eval has completed, it includes the metrics_report, so you don’t need to make another request to show scores.
examples is always [] on entries returned by this endpoint, regardless of what the eval actually declared. Fetch the eval with Get Eval for the real content.
A backward page is flipped so it still reads in the active sort direction, 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.
string
Cursor to step back the way this page was reached — pass it as before after a forward page, or as after after a backward one. null when the request carried no cursor.
integer
How many evals match the request’s filters across all pages, ignoring limit and the cursor. Present only when you set include_total=true. v2.0.1+