---
title: "Get pending evaluations"
method: GET
path: "/v1/public/evaluations/pending"
tags: ["public"]
---

# Get pending evaluations

`GET /v1/public/evaluations/pending`

Get all open work items awaiting validator evaluations, with queue summary.

## Query parameters

- `suite_id` integer, nullable — Filter by problem suite ID
- `limit` integer — Maximum items to return
- `offset` integer — Number of items to skip

## Response `200`

Successful Response

- PendingEvaluationsResponse
  - `summary` PendingEvaluationSummary, required
    - `total_pending` integer, required — Number of open work items
    - `total_runs_needed` integer, required — Sum of remaining runs across all items
    - `total_runs_active` integer, required — Sum of active runs across all items
    - `projected_completion_at` string, date-time, nullable — Projected UTC timestamp when the queue will fully drain. Null when the queue is empty, no validators are currently active, or there is insufficient evaluation history to project.
  - `items` PendingEvaluation[], required — Individual pending work items
    - `work_item_id` string, uuid, required — Unique work item identifier
    - `agent_version_id` string, uuid, required — Agent version being evaluated
    - `agent_name` string, required — Name of the agent
    - `version_number` integer, required — Version number within this agent
    - `miner_hotkey` string, required — Miner who owns the agent
    - `suite_id` integer, required — Problem suite ID
    - `required_successes` integer, required — Total successful evaluations needed
    - `completed_successes` integer, required — Successful evaluations completed so far
    - `active_runs` integer, required — Currently CLAIMED or RUNNING evaluations
    - `remaining` integer, required — Additional validator claims still needed
    - `queued_at` string, date-time, required — When this work item was created
    - `phase` string, nullable — Evaluation phase (QUALIFYING or RACE)
    - `race_id` string, uuid, nullable — Race ID when phase is RACE

## 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)
