---
title: "retrieve cluster membership status"
method: GET
path: "/mockserver/cluster"
tags: ["cluster"]
---

# retrieve cluster membership status

`GET /mockserver/cluster`

## Request

- Base URL: `http://localhost:1080`
- URL: `http://localhost:1080/mockserver/cluster`
- Auth: none declared

Reports whether this instance is running clustered, its node id, whether it is the coordinator, and the current member list. `clusterName` is omitted entirely when the instance is not clustered.

## Response `200`

cluster status returned

- object
  - `clustered` boolean
  - `nodeId` string
  - `coordinator` boolean
  - `clusterName` string
  - `memberCount` integer
  - `members` object[]
    - `id` string
    - `coordinator` boolean
    - `local` boolean

## Other responses

- `500`: an unexpected failure inside MockServer; the error field names a correlation id for the MockServer log

---

[API](https://skmtc.dev/mock-server/apis/mockserver-api.md) · [All operations](https://skmtc.dev/mock-server/apis/mockserver-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mock-server/apis/mockserver-api/revisions/9239b693996e?raw)