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

get_car_history(
  vin="1HGCV1F34JA123456"
)

History sorted oldest first

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

Fetch specific fields only (reduce response size)

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

Paginate through large history

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

Common Workflow

For comprehensive vehicle valuation research:

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