---
title: "List miners with ban status and agent count"
method: GET
path: "/v1/admin/miners"
tags: ["admin"]
---

# List miners with ban status and agent count

`GET /v1/admin/miners`

List all miners with their ban status, agent count, and last submission time.

## Query parameters

- `is_banned` boolean, nullable — Filter by ban status
- `since` string, date-time, nullable — Last submitted at or after
- `until` string, date-time, nullable — Last submitted at or before
- `limit` integer — Number of miners to return
- `offset` integer — Offset for pagination

## Response `200`

Successful Response

- AdminMinersResponse
  - `total` integer, required — Total entries matching filter
  - `limit` integer, required — Page size
  - `offset` integer, required — Page offset
  - `miners` AdminMinerEntry[], required — Miner entries
    - `miner_hotkey` string, required — Miner's SS58 hotkey
    - `is_banned` boolean, required — Whether the miner is banned
    - `ban_reason` string, nullable — Reason for the ban
    - `banned_at` string, date-time, nullable — When the miner was banned
    - `agent_count` integer, required — Number of agents submitted by this miner
    - `last_submitted_at` string, date-time, nullable — When the miner last submitted an agent
    - `registered_at` string, date-time, nullable — When the miner registered on-chain
    - `cooldown_remaining_seconds` integer, nullable — Remaining submission cooldown in seconds, or null if no cooldown is active. Sourced from Redis (`cooldown:miner:{hotkey}` TTL).

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