# List market maps

`GET` `/api/v1/market-maps`

Return market maps owned by the account linked to the API key.
By default only ACTIVE market maps are returned; pass `?status=all`
to include inactive ones.

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| status | string | no | Filter by status: 'active' (default) or 'all'. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | UUID of the market map |
| name | string | Market map name |
| status | string | Market map status (ACTIVE or INACTIVE) |
| source_type | string | How the market map was created (e.g. csv, crm) |
| analyzed_count | integer | Number of accounts analyzed (from latest completed run) |
| mapped_count | integer | Number of accounts placed on the map (from latest completed run) |
| tier1_count | integer | Tier 1 accounts (from latest completed run) |
| latest_run_status | string | Status of the most recent run |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-updated timestamp |

## Errors

| Status | Description |
|--------|-------------|
| 403 | Forbidden |