# Get market map

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

Retrieve a single market map by its ID, including the latest run
status and statistics from the latest completed run.

## Path parameters

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

## 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 |
| mapped_count | integer | Number of accounts placed on the map |
| tier1_count | integer | Tier 1 accounts |
| latest_run | object | The most recent run for this market map |
| latest_run.id | string | UUID of the run |
| latest_run.status | string | Run status: PENDING, PROCESSING, COMPLETE, FAILED, or CANCELED |
| latest_run.status_message | string | Human-readable status detail |
| latest_run.source_type | string | Source type (csv, salesforce_report, hubspot_list, project) |
| latest_run.source_name | string | Display name of the source |
| latest_run.credit_cost | integer | Research credits consumed |
| latest_run.analyzed_count | integer | Total accounts analyzed (null until complete) |
| latest_run.mapped_count | integer | Accounts placed on the map (null until complete) |
| latest_run.tier1_count | integer | Tier 1 accounts (null until complete) |
| latest_run.created_at | string | ISO-8601 creation timestamp |
| latest_run.updated_at | string | ISO-8601 last-updated timestamp |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-updated timestamp |

## Errors

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