DOCUMENTATION: Vehicle Market Value API

Vehicle Market Value API

The Vehicle Market Value API estimates the retail, wholesale, and trade-in values for passenger vehicles located in the United States and Canada. This market value by VIN or Year/Make/Model/Trim is based on millions of comparable vehicle sales stored in VinAudit’s sales database. Access to the vehicle market value API requires an API account with Market Value access enabled.

Vehicle Market Value API

Documentation

When searching by VIN:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&vin=2T1BURHE3EC020936

When searching by ID:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&id=2014_toyota_corolla_s

With GET or POST parameters:

Parameter	Description	Required	Example
vin	The vehicle identification number	yes (when querying by VIN)	2T1BURHE3EC020936
id	The unique identifier for the year/make/model/trim combination as returned by the selections function of VinAudit’s Specifications API. (Note: This id should not be constructed text but rather be selected from our Specifications API)	yes (when querying by ID)	2014_toyota_corolla_s
key	Your VinAudit API key	yes	YOUR_API_KEY_HERE
format	The output format: json (default) xml html	(optional)	json
mileage	The current mileage of the vehicle (if not specified, average mileage is used)	(optional)	90000
period	Number of days to look back for sales data (max: 365)	(optional)	90
type	Market type for valuation. Options: retail (default) – Consumer market pricing wholesale – Dealer auction pricing tradein – Trade-in value pricing	(optional)	retail
condition	Vehicle condition adjustment. Options: average (default) like_new not_great	(optional)	average
known_damage	Known vehicle damage that affects pricing. Options: frame_damage – Major structural damage airbags_deployed – Airbag deployment history salvage – Salvage title history brand – Branded title rollback – Odometer rollback minor_damage – Minor accident damage lemon – Lemon law vehicle rental – Former rental vehicle prior_theft – Vehicle has prior theft history	(optional)	frame_damage
country	Country for market valuation. Options: usa (default) canada	(optional)	usa

Response attributes:

Parameter	Description	Example
success	Whether market value data has been retrieved	true
vin	The vehicle identification number	2T1BURHE3EC020936
id	The unique vehicle YMMT ID	2014_toyota_corolla_s
vehicle	The vehicle title (Year, Make, Model, Trim)	2014 Toyota Corolla S
mileage	The mileage used to compute the market value	75248
count	The number of data points used for estimate	120
mean	The estimate average market price	7044
stdev	Standard deviation of prices	1276
certainty	The statistical confidence in the market value	99
period	The date range of the historical sales data used	[“2015-06-27″,”2015-07-16”]
prices	The estimated average market, below market, and above market prices	{“average”:7044, “below”:5768, “above”:8320}
prices.distribution	Price distribution buckets showing ranges and counts of data points	{ “min”: 2495, “max”: 2995, “count”: 10 }
adjustments	Breakdown of adjustments applied to the market value based on mileage, history, condition, and known damage	See nested fields below
adjustments.mileage	Adjustment applied based on vehicle mileage	{ “average”: 167391.71, “input”: 167391.71, “adjustment”: 0 }
adjustments.history	Adjustment applied based on vehicle history records	{ “records”: [], “adjustment”: 0 }
adjustments.condition	Adjustment applied for vehicle condition (e.g., like_new, not_great)	{ “input”: “not_great”, “adjustment”: -1472 }
adjustments.known_damage	Adjustment applied for known vehicle damage (e.g., minor_damage, frame_damage, lemon)	{ “input”:”frame_damage”, “adjustment”:-2325 }
type	Market type for valuation (retail, wholesale, or tradein)	wholesale

Error responses:

Error Code	Description
`invalid_key`	The API key is missing, invalid, disabled, or not authorized for the Market Value service.
`rate_limit_exceeded`	The API key is valid, but the account or key has reached its allowed rate or usage limit.
`no_data`	The request was valid, but there is not enough pricing data available to return a reliable market value.
`invalid_vehicle`	The vehicle input could not be matched to a valid vehicle record.
`invalid_request`	The request is missing required information or contains unsupported or invalid parameter values.
`internal_error`	The request could not be completed due to a temporary service issue. Please retry later.

Examples

Example Request by VIN

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&period=90&mileage=average&vin=2T1BURHE3EC020936

Response:

{"vin": "2T1BURHE3EC020936", "success": true, "id": "2014_toyota_corolla_s", "vehicle": "2014 Toyota Corolla S", "mean": 10880.54, "stdev": 2400, "count": 271, "mileage": 130163, "certainty": 99, "period": ["2025-08-17", "2025-10-10"], "prices": {"above": 13281.53, "average": 10880.54, "below": 8479.55, "distribution": [{"group": {"count": 28, "max": 7993, "min": 5580}}, {"group": {"count": 27, "max": 8900, "min": 7993}}, {"group": {"count": 27, "max": 9495, "min": 8900}}, {"group": {"count": 27, "max": 9995, "min": 9495}}, {"group": {"count": 27, "max": 10990, "min": 9995}}, {"group": {"count": 27, "max": 11500, "min": 10990}}, {"group": {"count": 27, "max": 12399, "min": 11500}}, {"group": {"count": 27, "max": 12995, "min": 12399}}, {"group": {"count": 27, "max": 13995, "min": 12995}}, {"group": {"count": 27, "max": 16031, "min": 13995}}]}, "adjustments": {"mileage": {"adjustment": 0, "average": 130163.9, "input": 130163.9}, "history": {"records": [], "adjustment": 0}, "condition": {"input": null, "adjustment": 0}, "known_damage": {"input": null, "adjustment": 0}}, "type": "retail"}

Example Request by ID

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&period=90&mileage=average&id=2005_toyota_corolla_ce

Response:

{"vin": null, "success": true, "id": "2005_toyota_corolla_ce", "vehicle": "2005 Toyota Corolla CE", "mean": 4728.67, "stdev": 1290, "count": 97, "mileage": 167103, "certainty": 99, "period": ["2025-08-17", "2025-09-24"], "prices": {"average": 4728.67, "below": 3438.1, "above": 6019.24, "distribution": [{"group": {"min": 2495, "max": 2995, "count": 10}}, {"group": {"min": 2995, "max": 3500, "count": 10}}, {"group": {"min": 3500, "max": 3995, "count": 10}}, {"group": {"min": 3995, "max": 4495, "count": 9}}, {"group": {"min": 4495, "max": 4800, "count": 10}}, {"group": {"min": 4800, "max": 4995, "count": 10}}, {"group": {"min": 4995, "max": 5000, "count": 9}}, {"group": {"min": 5000, "max": 5991, "count": 10}}, {"group": {"min": 5991, "max": 6900, "count": 10}}, {"group": {"min": 6900, "max": 7000, "count": 9}}]}, "adjustments": {"mileage": {"average": 167103.09, "input": 167103.09, "adjustment": 0}, "history": {"records": [], "adjustment": 0}, "condition": {"input": null, "adjustment": 0}, "known_damage": {"input": null, "adjustment": 0}}, "type": "retail"}

Example Retail Request

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&vin=2T1BURHE3EC020936&type=retail

Response:

{"vin": "2T1BURHE3EC020936", "success": true, "id": "2014_toyota_corolla_s", "vehicle": "2014 Toyota Corolla S", "mean": 10882.53, "stdev": 2396, "count": 255, "mileage": 129598, "certainty": 99, "period": ["2025-08-17", "2025-10-06"], "prices": {"above": 13279.11, "average": 10882.53, "below": 8485.95, "distribution": [{"group": {"count": 26, "max": 7993, "min": 5580}}, {"group": {"count": 26, "max": 8900, "min": 7993}}, {"group": {"count": 25, "max": 9495, "min": 8900}}, {"group": {"count": 26, "max": 9995, "min": 9495}}, {"group": {"count": 25, "max": 10990, "min": 9995}}, {"group": {"count": 26, "max": 11500, "min": 10990}}, {"group": {"count": 25, "max": 12468, "min": 11500}}, {"group": {"count": 26, "max": 12995, "min": 12468}}, {"group": {"count": 25, "max": 13995, "min": 12995}}, {"group": {"count": 25, "max": 16031, "min": 13995}}]}, "adjustments": {"mileage": {"adjustment": 0, "average": 129598.16, "input": 129598.16}, "history": {"records": [], "adjustment": 0}, "condition": {"input": null, "adjustment": 0}, "known_damage": {"input": null, "adjustment": 0}}, "type": "retail"}

Example Wholesale Request

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&vin=2T1BURHE3EC020936&type=wholesale

Response:

{"vin": "2T1BURHE3EC020936", "success": true, "id": "2014_toyota_corolla_s", "vehicle": "2014 Toyota Corolla S", "mean": 5802.13, "stdev": 2396, "count": 255, "mileage": 129598, "certainty": 99, "period": ["2025-08-17", "2025-10-06"], "prices": {"above": 13279.11, "average": 10882.53, "below": 8485.95, "distribution": [{"group": {"count": 26, "max": 7993, "min": 5580}}, {"group": {"count": 26, "max": 8900, "min": 7993}}, {"group": {"count": 25, "max": 9495, "min": 8900}}, {"group": {"count": 26, "max": 9995, "min": 9495}}, {"group": {"count": 25, "max": 10990, "min": 9995}}, {"group": {"count": 26, "max": 11500, "min": 10990}}, {"group": {"count": 25, "max": 12468, "min": 11500}}, {"group": {"count": 26, "max": 12995, "min": 12468}}, {"group": {"count": 25, "max": 13995, "min": 12995}}, {"group": {"count": 25, "max": 16031, "min": 13995}}]}, "adjustments": {"mileage": {"adjustment": 0, "average": 129598.16, "input": 129598.16}, "history": {"records": [], "adjustment": 0}, "condition": {"input": null, "adjustment": 0}, "known_damage": {"input": null, "adjustment": 0}}, "type": "wholesale"}

Example Trade-in Request

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&vin=2T1BURHE3EC020936&type=tradein

Response:

{"vin": "2T1BURHE3EC020936", "success": true, "id": "2014_toyota_corolla_s", "vehicle": "2014 Toyota Corolla S", "mean": 5715.1, "stdev": 2396, "count": 255, "mileage": 129598, "certainty": 99, "period": ["2025-08-17", "2025-10-06"], "prices": {"above": 13279.11, "average": 10882.53, "below": 8485.95, "distribution": [{"group": {"count": 26, "max": 7993, "min": 5580}}, {"group": {"count": 26, "max": 8900, "min": 7993}}, {"group": {"count": 25, "max": 9495, "min": 8900}}, {"group": {"count": 26, "max": 9995, "min": 9495}}, {"group": {"count": 25, "max": 10990, "min": 9995}}, {"group": {"count": 26, "max": 11500, "min": 10990}}, {"group": {"count": 25, "max": 12468, "min": 11500}}, {"group": {"count": 26, "max": 12995, "min": 12468}}, {"group": {"count": 25, "max": 13995, "min": 12995}}, {"group": {"count": 25, "max": 16031, "min": 13995}}]}, "adjustments": {"mileage": {"adjustment": 0, "average": 129598.16, "input": 129598.16}, "history": {"records": [], "adjustment": 0}, "condition": {"input": null, "adjustment": 0}, "known_damage": {"input": null, "adjustment": 0}}, "type": "tradein"}

Example Condition and Damage Adjustments Request

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&vin=2T1BURHE3EC020936&type=wholesale&known_damage=minor_damage&condition=not_great

Response:

{"vin": "2T1BURHE3EC020936", "success": true, "id": "2014_toyota_corolla_s", "vehicle": "2014 Toyota Corolla S", "mean": 4276.55, "stdev": 2400, "count": 271, "mileage": 130163, "certainty": 99, "period": ["2025-08-17", "2025-10-10"], "prices": {"above": 13281.53, "average": 10880.54, "below": 8479.55, "distribution": [{"group": {"count": 28, "max": 7993, "min": 5580}}, {"group": {"count": 27, "max": 8900, "min": 7993}}, {"group": {"count": 27, "max": 9495, "min": 8900}}, {"group": {"count": 27, "max": 9995, "min": 9495}}, {"group": {"count": 27, "max": 10990, "min": 9995}}, {"group": {"count": 27, "max": 11500, "min": 10990}}, {"group": {"count": 27, "max": 12399, "min": 11500}}, {"group": {"count": 27, "max": 12995, "min": 12399}}, {"group": {"count": 27, "max": 13995, "min": 12995}}, {"group": {"count": 27, "max": 16031, "min": 13995}}]}, "adjustments": {"mileage": {"adjustment": 0, "average": 130163.9, "input": 130163.9}, "history": {"records": [], "adjustment": 0}, "condition": {"input": "not_great", "adjustment": -812}, "known_damage": {"input": "minor_damage", "adjustment": -1176}}, "type": "wholesale"}

Example Unsuccessful Request

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&period=90&mileage=average&vin=MVXBR12EXCP901213

Response:

{"vehicle":null,"success":false,"error":"An error occurred. Please try again in a few minutes. If the issue persists, contact prodsupport@vinaudit.com for assistance.","vin":"MVXBR12EXCP901213","data":"no_data"}

DOCUMENTATION: Vehicle Market Value API

Vehicle Market Value API

Example Request by VIN

Example Request by ID

Example Retail Request

Example Wholesale Request

Example Trade-in Request

Example Condition and Damage Adjustments Request

Example Unsuccessful Request

SERVICES

RESOURCES

CUSTOMERS

ABOUT US

, Inc.