Skip to main content
GET
CSharp (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

schedule_id
string
required

Query Parameters

after
string

Row cursor from a previous page's last_id. Page with a fixed filter set: the cursor row is resolved by id regardless of the other filters, so replaying one taken under different filters skips a row instead of resuming cleanly.

limit
integer
default:20
Required range: 1 <= x <= 100
suite_id
string

Narrow to one suite's runs. Omit for every suite you can see; an empty value is rejected rather than treated as omitted, so a client that interpolates an undefined variable fails instead of silently widening the read.

Minimum string length: 1
suite_version
integer

Narrow to runs recorded against one version of the suite. Version is a per-suite ordinal, so this requires suite_id on /evals/runs; on /evals/schedules/{schedule_id}/runs the schedule already pins the suite. Scores are only comparable within a version. A version the suite does not have returns an empty list, not 404, so it is indistinguishable from a version with no runs yet.

Required range: 1 <= x <= 2147483647
status
enum<string>
Available options:
queued,
in_progress,
finalizing,
completed,
failed,
cancelling,
cancelled

Response

200 - application/json

OK

object
any
required
data
object[]
required
has_more
boolean
required
first_id
string
last_id
string