---
title: "Get Agents"
method: GET
path: "/cabinet/admin/ban-system/agents"
tags: ["Cabinet Admin Ban System"]
---

# Get Agents

`GET /cabinet/admin/ban-system/agents`

Get list of monitoring agents.

## Query parameters

- `search` string, nullable
- `health` string, nullable — healthy, warning, critical
- `status` string, nullable — online, offline

## Response `200`

Successful Response

- BanAgentsListResponse — List of agents.
  - `agents` BanAgentItem[]
    - `node_name` string, required
    - `sent_total` integer
    - `dropped_total` integer
    - `batches_total` integer
    - `reconnects` integer
    - `failures` integer
    - `queue_size` integer
    - `queue_max` integer
    - `dedup_checked` integer
    - `dedup_skipped` integer
    - `filter_checked` integer
    - `filter_filtered` integer
    - `health` string
    - `is_online` boolean
    - `last_report` string, date-time, nullable
  - `summary` BanAgentsSummary — Agents summary statistics.
    - `total_agents` integer
    - `online_agents` integer
    - `total_sent` integer
    - `total_dropped` integer
    - `avg_queue_size` number
    - `healthy_count` integer
    - `warning_count` integer
    - `critical_count` integer
  - `total` integer
  - `online` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api.md) · [All operations](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bedolagam/remnawave-bot-admin-api/versions/45956d1b13ec/schema)