---
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 — Seconds since the node started. For a peer this is derived from the start time that node published, so a cluster without synchronised clocks reports it approximately; it is never negative.
    - `version` string — Build version the node reports for itself, for watching a rolling upgrade. Absent for a peer that has not registered its metadata yet, or that has already shut down. It is a label, not an ordering, and says nothing about which features that peer has enabled.

## Other responses

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

## Changes

- **2026-09-03** `c0dcbfa396c1` — 1 info
  - added the optional property `nodes/items/version` to the response with the `200` status

[Change history](https://skmtc.dev/absmach/apis/fluxmq-admin-api/changes/api/v1/cluster/get.md)

---

[API](https://skmtc.dev/absmach/apis/fluxmq-admin-api.md) · [All operations](https://skmtc.dev/absmach/apis/fluxmq-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/absmach/fluxmq-admin-api/revisions/c0dcbfa396c1/schema)