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
page_token
string

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

sortBy
enum<string>
default:created_at

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

Available options:
created_at,
updated_at,
status
sortDirection
enum<string>
default:desc

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

Available options:
asc,
desc

Response

One page of organization-scoped evaluation-run summaries and an optional continuation.

One page of organization-scoped evaluation-run summaries and an optional continuation.

evaluation_runs
object[]
required

Newest-first platform-internal evaluation-run summaries for this page.

next_page_token
string

Signed one-hour continuation bound to the organization and effective limit.