---
title: "Cluster topology"
method: GET
path: "/api/v1/cluster"
tags: ["Admin"]
---

# Cluster topology

`GET /api/v1/cluster`

Returns cluster topology and per-node health. In single-node mode
(no cluster configured), returns `cluster_mode: false` with
`node_id: "single-node"`.

## Response `200`

Cluster topology and node health

- ClusterResponse
  - `node_id` string
  - `cluster_mode` boolean — Whether the broker is running in cluster mode
  - `is_leader` boolean
  - `nodes` NodeResponse[]
    - `id` string
    - `address` string — Inter-broker transport address
    - `healthy` boolean
    - `leader` boolean
    - `uptime_seconds` number, double

## Other responses

- `405` — Method not allowed
- `503` — Broker not available

---

[API](https://skmtc.net/absmach/apis/fluxmq-admin-api.md) · [All operations](https://skmtc.net/absmach/apis/fluxmq-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/absmach/fluxmq-admin-api/versions/55b06d78c850/schema)