Skip to main content
GET
List evaluation runs

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Query Parameters

limit
integer
default:50

Maximum runs to return. Defaults to 50.

Required range: 1 <= x <= 100
cursor
string

Opaque signed continuation from nextCursor. It is bound to this organization, sort, and effective limit and expires after one hour.

sortBy
enum<string>
default:createdAt

Column every run is ordered by before pagination. Ties break on runSessionId, so pages neither skip nor repeat a run. status orders each status group by updatedAt, most recent first when ascending. Any other value is rejected with 400.

Available options:
createdAt,
updatedAt,
status
sortDirection
enum<string>
default:desc

Direction of sortBy. Any other value is rejected with 400.

Available options:
asc,
desc

Response

OK

items
object[]
required

Evaluation-run summaries for this page, in the order selected by sortBy and sortDirection (newest first by default).

nextCursor
null | string
required

Signed one-hour continuation, or null.

total
null | integer
required

Always null; the run list does not count matching runs.

Required range: 0 <= x <= 9007199254740991