# List clusters

`GET` `/api/v1/market-maps/{id}/clusters`

Return every cluster with its name, summary, and account count.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| id | string | yes | UUID of the market map |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| cluster_id | integer | Cluster ID |
| name | string | Cluster name |
| summary | string | Cluster summary |
| account_count | integer | Number of accounts in this cluster |
| tier1_count | integer | Tier 1 accounts in this cluster |
| reference_count | integer | Reference (target) accounts in this cluster |
| average_score | number | Average score of accounts in this cluster |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 404 | Not Found |