# Get market map summary

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

Return top-level metrics for a market map: analyzed accounts, mapped accounts,
reference accounts, total clusters, clustered accounts, tier 1 accounts,
and a breakdown of accounts by tier.

## Path parameters

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

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| analyzed_count | integer | Total accounts analyzed |
| mapped_count | integer | Accounts placed on the map |
| reference_count | integer | Reference (target) accounts |
| total_clusters | integer | Number of clusters |
| clustered_accounts | integer | Accounts assigned to a cluster |
| tier1_count | integer | Tier 1 accounts (from DB) |
| accounts_by_tier | object | Account counts keyed by tier (score_bin): {'1': N, '2': N, ...} |

## Errors

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