Skip to main content
GET
List runs
Filterable by case_id, suite_run_id, status, and date range. Default sort is newest-first by created_at. To get the runs from one suite execution, pass back the suite_run_id returned by POST /agent-eval/suites/:id/run.

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Query Parameters

case_id
string<uuid>
suite_run_id
string<uuid>

Pass back the value returned by POST /agent-eval/suites/{id}/run to fetch only the runs from that suite execution.

status
enum<string>
Available options:
queued,
running,
completed,
failed,
cancelled
from
string<date-time>

Filter on created_at >= from.

to
string<date-time>

Filter on created_at < to.

limit
integer
default:20
Required range: x <= 100
offset
integer
default:0

Response

200 - application/json

List of runs. case is expanded inline (which itself expands agent and persona).

data
object[]
pagination
object