---
title: "List miner's agents"
method: GET
path: "/v1/miner/agents"
tags: ["miner"]
---

# List miner's agents

`GET /v1/miner/agents`

List all agents owned by the authenticated miner, with cooldown status.

Includes the latest version per agent with its state and score so the
frontend doesn't need to make N additional requests.

## Response `200`

Successful Response

- MinerAgentsResponse
  - `agents` AgentPublic[], required — List of agents owned by the miner
    - `agent_id` string, uuid, required — Unique identifier for the agent
    - `miner_hotkey` string, required — Owner's hotkey
    - `agent_name` string, required — Human-readable name for the agent
    - `created_at` string, date-time, required — When the agent was created
    - `latest_version` AgentLatestVersion
      - `eliminated_at` string, date-time, nullable — When the agent was eliminated from future races, if any
      - `eliminated_in_race_number` integer, nullable — Race number that eliminated this agent, if any
      - `agent_version_id` string, uuid, required — Version ID
      - `version_number` integer, required — Version number (v1, v2, etc.)
      - `submitted_at` string, date-time, required — Submission timestamp
      - `state` 'RECEIVED' | 'QUEUED' | 'RUNNING' | 'ELIGIBLE' | 'DISCARDED' | 'CANCELLED', required — State of an agent version evaluation.
      - `final_score` number, nullable — Final score if eligible
      - `is_selected_for_race` boolean — True when this version is the miner's pinned race candidate
      - `selection_fallback_reason` 'eliminated' | 'discarded' | 'below_threshold' | 'not_eligible', nullable — Set on the pinned version only when the pin can't take effect.
      - `is_pinnable` boolean — True when this version can be pinned as the next race candidate. Mirrors the admission rules used by the PUT /v1/miner/race-selection endpoint.
      - `pin_disabled_reason` 'eliminated' | 'discarded' | 'below_threshold' | 'not_eligible', nullable — When `is_pinnable` is false, the specific precondition that fails. Same enum as `selection_fallback_reason`.
  - `can_submit` boolean, required — Whether the miner is currently allowed to submit a new agent
  - `next_allowed_at` string, date-time, nullable — Earliest time the miner may submit again, if on cooldown
  - `racing_agent_version_id` string, uuid, nullable — The agent_version_id this miner would race with right now: the explicitly pinned version when valid, otherwise the picker's auto-pick (highest-scoring eligible version on this hotkey >= the qualifying threshold). None when nothing on this hotkey qualifies.
  - `racing_agent_id` string, uuid, nullable — The agent_id that owns racing_agent_version_id. Surfaced alongside the version id so the dashboard can highlight the right row even when the racing version isn't that agent's latest. None when racing_agent_version_id is None.

---

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