Skip to main content
GET
List eval runs

Authorizations

x-api-key
string
header
required

Query Parameters

session_id
string<uuid> | null
evaluator_id
string<uuid> | null
agent_id
string<uuid> | null
status
enum<string> | null
Available options:
pending,
running,
completed,
failed,
errored
scope
enum<string> | null
Available options:
live,
simulation,
test
outcome
enum<string> | null
Available options:
passed,
failed,
no_verdict,
errored
score_min
number | null

Min normalized score, matched against EvalScore.value [0,1]. numeric-format evaluators store their signal in raw_value (value is null), so they are not matched by score_min/score_max.

Required range: 0 <= x <= 1
score_max
number | null

Max normalized score [0,1]; see score_min re: numeric evaluators.

Required range: 0 <= x <= 1
severity
enum<string> | null
Available options:
info,
low,
medium,
high,
critical
channel
string | null
created_from
string<date-time> | null
created_to
string<date-time> | null
is_critical
boolean | null

Filter on the run's is_critical_snapshot. Omit for all runs; false returns non-critical runs only.

q
string | null

Case-insensitive substring match on the agent and evaluator names, plus the run / session / agent / evaluator ids (exact UUID, or an 8+ character id prefix). Runs whose agent_id is null (legacy rows) cannot be matched by agent name.

Maximum string length: 255
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string | null

Response

Successful Response

items
EvalRunResponse · object[]
required
has_more
boolean
required
next_cursor
string | null