DOCUMENTATION: Vehicle Market Value API

Vehicle Market Value API

The vehicle market value API estimates the market value for used and new cars by VIN based on millions of historical vehicle sales stored in VinAudit’s sales database. With the assumption that sale prices are normally distributed, VinAudit’s market value model estimates the “below market” and “above market” values within a distribution. Access to the vehicle market value API requires an API account with market value access enabled.

Vehicle Market Value API

Documentation

To query whether data for a VIN exists, request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&vin=1NXBR32E85Z505904

With GET or POST parameters:

Parameter	Description	Required	Example
vin	The vehicle identification number	yes	1NXBR32E85Z505904
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) – No adjustment like_new – +9.5% price adjustment not_great – -7.5% price adjustment	(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) us can canada	(optional)	usa

When searching by ID:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&id=2004_toyota_corolla_ce

Parameter	Description	Required	Examples
id	Unique identifier associated with each of the following attribute combinations: year_make_model_trim	yes	2004_toyota_corolla_ce
key	Your VinAudit API key	yes	YOUR_API_KEY_HERE
format	The output format: json (default) xml html	no	json
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) – No adjustment like_new – +9.5% price adjustment not_great – -7.5% price adjustment	(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) us can canada	(optional)	usa

When searching by YMMT (Year, Make, Model, Trim):

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&year=2004&make=toyota&model=corolla&trim=ce

Parameter	Description	Required	Examples
year	The selected vehicle year	yes	2004
make	The selected vehicle make	yes	toyota
model	The selected vehicle model	yes	corolla
trim	The selected vehicle trim	no	ce
key	Your VinAudit API key	yes	YOUR_API_KEY_HERE
format	The output format: json (default) xml html	no	json
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) – No adjustment like_new – +9.5% price adjustment not_great – -7.5% price adjustment	(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) us can canada	(optional)	usa

Response attributes:

Parameter	Description	Example
success	Whether market value data has been retrieved	true
vin	The vehicle identification number	1NXBR32E85Z505904
vehicle	The vehicle title (Make, Model, Year, Trim)	2004 Toyota Corolla CE
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 based on vehicle mileage	{ “average”: 167391.71, “input”: 167391.71, “adjustment”: 0 }
adjustments.history	Adjustment 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

Examples

Example Request by VIN

Request:

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

Response:

{"vin":"1VXBR12EXCP901213","success":true,"id":"2005_toyota_corolla_ce","vehicle":"2005 Toyota Corolla CE","mean":4754.01,"stdev":1300,"count":97,"mileage":168256,"certainty":99,"period":["2025-08-17","2025-09-24"],"prices":{"average":4754.01,"below":3453.55,"above":6054.47,"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":4850,"count":10}},{"group":{"min":4850,"max":4995,"count":10}},{"group":{"min":4995,"max":5357,"count":9}},{"group":{"min":5357,"max":5992,"count":10}},{"group":{"min":5992,"max":6900,"count":10}},{"group":{"min":6900,"max":7000,"count":9}}]},"adjustments":{"mileage":{"average":168256.9,"input":168256.9,"adjustment":0},"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 Request by YMMT (Year, Make, Model, Trim)

Request:

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&period=90&mileage=average&year=2005&make=toyota&model=corolla&trim=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=JM1NDAC79G0102660&type=retail

Response:

{"vin":"JM1NDAC79G0102660","success":true,"id":"2016_mazda_mx5_club","vehicle":"2016 Mazda MX-5 Miata Club","mean":19021.25,"stdev":3033,"count":103,"mileage":48983,"certainty":99,"period":["2025-08-18","2025-09-24"],"prices":{"average":19021.25,"below":15987.72,"above":22054.78,"distribution":[{"group":{"min":11995,"max":14496,"count":11}},{"group":{"min":14496,"max":16455,"count":10}},{"group":{"min":16455,"max":17000,"count":10}},{"group":{"min":17000,"max":18766,"count":11}},{"group":{"min":18766,"max":19485,"count":10}},{"group":{"min":19485,"max":19998,"count":10}},{"group":{"min":19998,"max":20990,"count":11}},{"group":{"min":20990,"max":21590,"count":10}},{"group":{"min":21590,"max":22277,"count":10}},{"group":{"min":22277,"max":28999,"count":10}}]},"adjustments":{"mileage":{"average":48983.19,"input":48983.19,"adjustment":0},"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=JM1NDAC79G0102660&type=wholesale

Response:

{"vin": "JM1NDAC79G0102660", "success": true, "id": "2016_mazda_mx5_club", "vehicle": "2016 Mazda MX-5 Miata Club", "mean": 13375.24, "stdev": 3033, "count": 103, "mileage": 48983, "certainty": 99, "period": ["2025-08-18", "2025-09-24"], "prices": {"average": 19021.25, "below": 15987.72, "above": 22054.78, "distribution": [{"group": {"min": 11995, "max": 14496, "count": 11}}, {"group": {"min": 14496, "max": 16455, "count": 10}}, {"group": {"min": 16455, "max": 17000, "count": 10}}, {"group": {"min": 17000, "max": 18766, "count": 11}}, {"group": {"min": 18766, "max": 19485, "count": 10}}, {"group": {"min": 19485, "max": 19998, "count": 10}}, {"group": {"min": 19998, "max": 20990, "count": 11}}, {"group": {"min": 20990, "max": 21590, "count": 10}}, {"group": {"min": 21590, "max": 22277, "count": 10}}, {"group": {"min": 22277, "max": 28999, "count": 10}}]}, "adjustments": {"mileage": {"average": 48983.19, "input": 48983.19, "adjustment": 0}, "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=JM1NDAC79G0102660&type=tradein

Response:

{"vin": "JM1NDAC79G0102660", "success": true, "id": "2016_mazda_mx5_club", "vehicle": "2016 Mazda MX-5 Miata Club", "mean": 13174.61, "stdev": 3033, "count": 103, "mileage": 48983, "certainty": 99, "period": ["2025-08-18", "2025-09-24"], "prices": {"average": 19021.25, "below": 15987.72, "above": 22054.78, "distribution": [{"group": {"min": 11995, "max": 14496, "count": 11}}, {"group": {"min": 14496, "max": 16455, "count": 10}}, {"group": {"min": 16455, "max": 17000, "count": 10}}, {"group": {"min": 17000, "max": 18766, "count": 11}}, {"group": {"min": 18766, "max": 19485, "count": 10}}, {"group": {"min": 19485, "max": 19998, "count": 10}}, {"group": {"min": 19998, "max": 20990, "count": 11}}, {"group": {"min": 20990, "max": 21590, "count": 10}}, {"group": {"min": 21590, "max": 22277, "count": 10}}, {"group": {"min": 22277, "max": 28999, "count": 10}}]}, "adjustments": {"mileage": {"average": 48983.19, "input": 48983.19, "adjustment": 0}, "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=JM1NDAC79G0102660&type=wholesale&known_damage=minor_damage&condition=not_great

Response:

{"vin": "JM1NDAC79G0102660", "success": true, "id": "2016_mazda_mx5_club", "vehicle": "2016 Mazda MX-5 Miata Club", "mean": 11053.29, "stdev": 3033, "count": 103, "mileage": 48983, "certainty": 99, "period": ["2025-08-18", "2025-09-24"], "prices": {"average": 19021.25, "below": 15987.72, "above": 22054.78, "distribution": [{"group": {"min": 11995, "max": 14496, "count": 11}}, {"group": {"min": 14496, "max": 16455, "count": 10}}, {"group": {"min": 16455, "max": 17000, "count": 10}}, {"group": {"min": 17000, "max": 18766, "count": 11}}, {"group": {"min": 18766, "max": 19485, "count": 10}}, {"group": {"min": 19485, "max": 19998, "count": 10}}, {"group": {"min": 19998, "max": 20990, "count": 11}}, {"group": {"min": 20990, "max": 21590, "count": 10}}, {"group": {"min": 21590, "max": 22277, "count": 10}}, {"group": {"min": 22277, "max": 28999, "count": 10}}]}, "adjustments": {"mileage": {"average": 48983.19, "input": 48983.19, "adjustment": 0}, "history": {"records": [], "adjustment": 0}, "condition": {"input": "not_great", "adjustment": -1472}, "known_damage": {"input": "minor_damage", "adjustment": -1394}}, "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": "no_data", "vin": "MVXBR12EXCP901213"}

DOCUMENTATION: Vehicle Market Value API

Vehicle Market Value API

Example Request by VIN

Example Request by ID

Example Request by YMMT (Year, Make, Model, Trim)

Example Retail Request

Example Wholesale Request

Example Trade-in Request

Example Condition and Damage Adjustments Request

Example Unsuccessful Request

The most comprehensive Automotive Data & Analytics

SERVICES

RESOURCES

CUSTOMERS

ABOUT US

, Inc.