---
title: "List validators including banned"
method: GET
path: "/v1/admin/validators"
tags: ["admin"]
---

# List validators including banned

`GET /v1/admin/validators`

List all validators including banned ones.

## Query parameters

- `is_banned` boolean, nullable — Filter by ban status
- `limit` integer — Page size
- `offset` integer — Offset

## Response `200`

Successful Response

- AdminValidatorsResponse
  - `total` integer, required — Total entries matching filter
  - `limit` integer, required — Page size
  - `offset` integer, required — Page offset
  - `validators` AdminValidatorEntry[], required — Validator entries
    - `hotkey` string, required — Validator's SS58 address
    - `name` string, nullable — On-chain identity name, if set
    - `status` 'evaluating' | 'available', required
    - `registered_at` string, date-time, required — When validator was registered
    - `last_claim_at` string, date-time, nullable — Last work claim time
    - `last_seen_at` string, date-time, nullable — Last time validator was seen
    - `current_agent` ValidatorCurrentAgent
      - `agent_name` string, required — Name of the agent being evaluated
      - `version_id` string, uuid, required — Agent version ID
      - `version_number` integer, required — Version number within this agent (v1, v2, etc.)
      - `started_at` string, date-time, required — When evaluation started
    - `service_versions` object, nullable — Docker image digests for validator stack services
    - `identity_url` string, nullable — On-chain identity URL
    - `identity_image` string, nullable — On-chain identity image URL
    - `identity_description` string, nullable — On-chain identity description
    - `cpu_pct` number, nullable — Latest reported host CPU utilisation percentage (0-100)
    - `ram_pct` number, nullable — Latest reported host RAM utilisation percentage (0-100)
    - `disk_pct` number, nullable — Latest reported host disk utilisation percentage on the sandbox volume (0-100)
    - `docker_container_count` integer, nullable — Latest reported running Docker container count on the host
    - `metrics_reported_at` string, date-time, nullable — UTC timestamp of the last resource-metrics report
    - `is_banned` boolean, required — Whether the validator is banned
    - `ban_reason` string, nullable — Reason for the ban
    - `banned_at` string, date-time, nullable — When the validator was banned
    - `max_concurrent_runs` integer, required — Maximum concurrent evaluation runs for this hotkey

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