---
title: "Returns all members of a cluster and their current status"
method: GET
path: "/cluster/list-members"
tags: ["Cluster"]
---

# Returns all members of a cluster and their current status

`GET /cluster/list-members`

## Request

- Base URL: `https://demo.ziti.dev/fabric/v1`
- URL: `https://demo.ziti.dev/fabric/v1/cluster/list-members`
- Auth: one of:
  - API key in header `zt-session`
  - OAuth 2
    - Authorization code: `/oidc/authorize`
    - Token URL: `/oidc/token` scopes: `openid`
- TypeScript: <https://skmtc.dev/openziti/apis/ziti-fabric/docs/cluster/list-members/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all members of a cluster and their current status

## Response `200`

A response to a cluster list-members request

- ClusterMemberListResponse
  - `data` ClusterMemberListValue[]
    - `id` string, required
    - `address` string, required
    - `voter` boolean, required
    - `leader` boolean, required
    - `version` string, required
    - `connected` boolean, required
    - `readOnly` boolean, required
    - `preferredLeader` boolean

## Other responses

- `400`: The supplied request contains invalid fields or could not be parsed (json and non-json bodies). The error's code, message, and cause fields can be inspected for further information
- `401`: The currently supplied session does not have the correct access rights to request this resource
- `429`: The resource requested is rate limited and the rate limit has been exceeded

## Changes

- **2025-01-31** `58650a0bd6d2`: 1 info
  - endpoint added
- **2023-08-16** `94130b45fa7e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/openziti/apis/ziti-fabric/changes/cluster/list-members/get.md)

---

[API](https://skmtc.dev/openziti/apis/ziti-fabric.md) - [All operations](https://skmtc.dev/openziti/apis/ziti-fabric/llms.txt) - [OpenAPI document](https://skmtc.dev/openziti/apis/ziti-fabric/revisions/b899875c8f57?raw)