---
title: "List the member addresses of a cluster"
method: POST
path: "/v1/cluster-mappings"
tags: ["Entities"]
---

# List the member addresses of a cluster

`POST /v1/cluster-mappings`

## Request

- Base URL: `https://intelapi.publicaml.org`
- URL: `https://intelapi.publicaml.org/v1/cluster-mappings`
- Auth: one of:
  - API key in header `X-API-Key`
  - none

Every address belonging to the given clusters. An exchange's deposit cluster can hold hundreds of thousands of addresses, so results are paged with a keyset cursor: send back the `next_cursor` from the previous page. A cursor is only valid with a single entity id.

## Request body

- object
  - `entity_ids` string[], required
  - `limit` integer
  - `cursor` string: `next_cursor` from the previous page. Single entity id only.

## Response `200`

Cluster members.

- object
  - `mappings` object[]
  - `not_found` object[]

## Other responses

- `400`: Malformed request.
- `429`: Rate limited: anonymous callers, and keys issued with a quota of their own. Authenticate to remove the limit.
- `500`: Server error.

---

[API](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api.md) · [All operations](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/publicaml/apis/publicaml-intelligence-api/revisions/7c0c6315088c?raw)