---
title: "List evaluation runs with full details"
method: GET
path: "/v1/admin/evaluation-runs"
tags: ["admin"]
---

# List evaluation runs with full details

`GET /v1/admin/evaluation-runs`

List evaluation runs with optional filtering and pagination.

## Query parameters

- `status` 'CLAIMED' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'TIMED_OUT' | 'STALE' | 'CANCELLED' — Status of an evaluation run through its lifecycle.
- `agent_version_id` string, uuid, nullable — Filter by agent version ID
- `validator_hotkey` string, nullable — Filter by validator hotkey
- `phase` 'QUALIFYING' | 'RACE' — Which phase of the qualifying+race cycle an evaluation belongs to.
- `race_id` string, uuid, nullable — Filter by race ID (RACE-phase runs only)
- `eval_work_item_id` string, uuid, nullable — Filter to runs for a specific work item
- `inference_provider` string, nullable — Filter by inference provider (e.g. chutes, openrouter). Pass 'none' to filter to runs with no provider recorded.
- `since` string, date-time, nullable — Filter: created at or after (ISO 8601)
- `until` string, date-time, nullable — Filter: created at or before (ISO 8601)
- `limit` integer — Number of runs to return
- `offset` integer — Offset for pagination

## Response `200`

Successful Response

- AdminEvaluationRunsResponse
  - `total` integer, required — Total entries matching filter
  - `limit` integer, required — Page size
  - `offset` integer, required — Page offset
  - `evaluation_runs` AdminEvaluationRunEntry[], required — Evaluation run entries
    - `run_id` string, uuid, required — Evaluation run ID
    - `agent_version_id` string, uuid, required — Agent version being evaluated
    - `validator_hotkey` string, required — Validator performing the evaluation
    - `suite_id` integer, required — Problem suite ID
    - `status` string, required — Current run status
    - `claimed_at` string, date-time, nullable — When the run was claimed
    - `completed_at` string, date-time, nullable — When the run completed
    - `last_heartbeat_at` string, date-time, nullable — Last heartbeat from the validator
    - `lease_expires_at` string, date-time, nullable — When the lease expires
    - `is_included` boolean, required — Whether this run is included in scoring
    - `score` number, nullable — Run score
    - `invalidated_at` string, date-time, nullable — When the run was invalidated
    - `invalidation_reason` string, nullable — Reason the run was invalidated
    - `failure_reason` string, nullable — Reason the run failed
    - `created_at` string, date-time, required — When the run was created
    - `eval_work_item_id` string, uuid, nullable — Work item this run was created for
    - `phase` string, nullable — Evaluation phase (QUALIFYING or RACE) from the work item
    - `race_id` string, uuid, nullable — Race ID for RACE-phase runs
    - `race_number` integer, nullable — Race number for RACE-phase runs
    - `inference_provider` string, nullable — Inference provider used for this run (e.g. chutes, openrouter)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/oroagents/apis/oro-api.md) · [All operations](https://skmtc.dev/oroagents/apis/oro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oroagents/oro-api/revisions/38ef86138115/schema)