Market Data

Market Values API

Estimates retail, wholesale, and trade-in values for passenger vehicles in the US and Canada using comparable sales records. Submit either vin or id. Also accepts POST with the same parameters.

get/v2/marketvalue

Request

Query parameters

vinstring
Example:2T1BURHE3EC020936

Vehicle identification number.

idstring
Example:2014_toyota_corolla_s

Year/make/model/trim ID as returned by the VIN Decoder selections function.

format'json' | 'xml' | 'html'
mileagestring
Example:90000

Numeric mileage or average. Defaults to average mileage.

periodinteger
Example:90

Days to look back for sales data (max 365).

type'retail' | 'tradein'
condition'average' | 'like_new' | 'not_great'
known_damage'frame_damage' | 'airbags_deployed' | 'salvage' | 'brand' | 'rollback' | 'minor_damage' | 'lemon' | 'rental' | 'prior_theft'
country'usa' | 'canada'

usa (USD, miles) or canada (CAD, km).

Response

Market value estimate

successboolean
vinstring nullable
idstring
vehiclestring
mileagenumber
countinteger

Data points used for the estimate

meannumber
stdevnumber
certaintyinteger
periodstring[]
type'retail' | 'wholesale' | 'tradein'

Changes

No recorded changes to this operation across all 1 revision of this API.