# Car History

> Full reference for the get_car_history tool — retrieve complete online listing history for any vehicle by VIN, including price changes, dealer history, and days on market.

Retrieve the complete online listing history for a vehicle identified by its VIN. History listings are sorted by listing date, showing every price change, dealer transfer, and market exposure period.



## Overview

| Property | Value    |
|----------|----------|
| Tool name | `get_car_history` |
| Markets | US, Canada |
| Required | VIN (17 characters) |
| API endpoint | `GET /v2/history/car/{vin}` |
| Default sort | Descending by listing date / last seen date |




## Parameters

| Parameter   | Type        | Default     | Required    | Description |
|-------------|-------------|-------------|-------------|-------------|
| `vin` | string | — | **Yes** | 17-character Vehicle Identification Number |
| `fields` | string | — | No | Comma-separated list of specific fields to return (reduces response size) |
| `page` | int | `1` | No | Page number for pagination |
| `sort_order` | string | `"asc"` | No | `"asc"` or `"desc"` |




## Response Data

Each historical listing record includes:

- **Listing ID** — Unique identifier for this specific listing instance
- **Price** — Listed price at the time
- **Mileage** — Odometer reading
- **Listing dates** — First seen and last seen timestamps
- **Dealer info** — Dealer name, location
- **Days on market** — Duration of that specific listing
- **VDP URL** — Vehicle detail page link



## Key Insights from History

| Analysis       | How to Extract |
|----------------|----------------|
| Price trajectory | Compare `price` across listing records chronologically |
| Time on market | Review `dom` (days on market) per listing period |
| Dealer transfers | Track which dealers have listed the vehicle and when |
| Listing ID changes | Each price or mileage update creates a new listing ID |
| Active vs. historical | Returns all listing records for a VIN — both active and expired |




## Use Cases



### Full listing history for a VIN

```text
get_car_history(
  vin="1HGCV1F34JA123456"
)
```



### History sorted oldest first

```text
get_car_history(
  vin="1HGCV1F34JA123456",
  sort_order="asc"
)
```



### Fetch specific fields only (reduce response size)

```text
get_car_history(
  vin="1HGCV1F34JA123456",
  fields="id,price,miles,dom,first_seen_at,last_seen_at,dealer.name"
)
```



### Paginate through large history

```text
get_car_history(
  vin="1HGCV1F34JA123456",
  page=2
)
```



## Common Workflow

For comprehensive vehicle valuation research:

1. **Decode specs** — `decode_vin_neovin(vin=...)` to confirm vehicle identity
2. **Check price history** — `get_car_history(vin=...)` to see how the price has changed over time
3. **Get current market price** — `predict_price_with_comparables(vin=..., miles=...)` for today's valuation



## See Also

- [VIN Decode](/docs/get-started/api/mcp/tools/decode-vin) — Decode VIN for full vehicle specs
- [Price Prediction](/docs/get-started/api/mcp/tools/predict-price) — Current market valuation
- [Search Past 90 Days](/docs/get-started/api/mcp/tools/search-past-90-days) — Broader market historical data