Vehicle Market Value (v2)
Get detailed market values for a VIN, including wholesale, retail, trade-in, and auction values across condition tiers. The response includes mileage_list (odometer-band adjustments, with finadv and mileage_cat when present) and add_deduct_list (option/equipment adds and deducts). Pass mileage with condition to apply the matching band into mileage_* automatically; otherwise apply bands yourself. Optional state selects the regional adjustment.
Get detailed market values for a VIN, including wholesale, retail, trade-in, and auction values across condition tiers. The response includes mileage_list (odometer-band adjustments, with finadv and mileage_cat when present) and add_deduct_list (option/equipment adds and deducts). Pass mileage with condition to apply the matching band into mileage_* automatically; otherwise apply bands yourself. Optional state selects the regional adjustment.
Your CarsXE API key, passed as the key query parameter.
In: query
Query Parameters
The 17 character long vehicle identification number.
"WBAFR7C57CC811956"17 <= length <= 17The US state of the vehicle to get the market value for.
The current odometer reading (miles in the US, kilometers in Canada). When passed with condition, the API selects the matching mileage_list band and writes it into mileage_, then recalculates adjusted_. Omit mileage to apply bands yourself.
Overall condition: excellent, clean, average, or rough. excellent maps to the xclean response tier. Used with mileage to apply the matching band.
"excellent" | "clean" | "average" | "rough"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -G https://api.carsxe.com/v2/marketvalue \ -d key=CARSXE_API_KEY \ -d vin=WBAFR7C57CC811956{
"uid": "6AA32D4C",
"input": {
"vin": "3KPFK4A78HE103497",
"state": "CA",
"country": "US"
},
"publish_date": "8/29/2025",
"data_freq": "D",
"state": "CA",
"country": "US",
"uvc": "2017485075",
"group_num": "4163",
"model_year": "2017",
"make": "Kia",
"model": "Forte",
"series": "LX",
"style": "4D Sedan",
"mileage_cat": "B",
"class_code": "A",
"class_name": "Small Car",
"description_score": "",
"first_values_flag": false,
"risk_score": "",
"whole_xclean": {
"base_whole_xclean": 5925,
"mileage_whole_xclean": 0,
"add_deduct_whole_xclean": 0,
"regional_whole_xclean": 25,
"adjusted_whole_xclean": 5950
},
"whole_clean": {
"base_whole_clean": 4950,
"mileage_whole_clean": 0,
"add_deduct_whole_clean": 0,
"regional_whole_clean": 25,
"adjusted_whole_clean": 4975
},
"whole_avg": {
"base_whole_avg": 3600,
"mileage_whole_avg": 0,
"add_deduct_whole_avg": 0,
"regional_whole_avg": 25,
"adjusted_whole_avg": 3625
},
"whole_rough": {
"base_whole_rough": 2300,
"mileage_whole_rough": 0,
"add_deduct_whole_rough": 0,
"regional_whole_rough": 25,
"adjusted_whole_rough": 2325
},
"retail_xclean": {
"base_retail_xclean": 9750,
"mileage_retail_xclean": 0,
"add_deduct_retail_xclean": 0,
"regional_retail_xclean": 25,
"adjusted_retail_xclean": 9775
},
"retail_clean": {
"base_retail_clean": 8575,
"mileage_retail_clean": 0,
"add_deduct_retail_clean": 0,
"regional_retail_clean": 25,
"adjusted_retail_clean": 8600
},
"retail_avg": {
"base_retail_avg": 6550,
"mileage_retail_avg": 0,
"add_deduct_retail_avg": 0,
"regional_retail_avg": 25,
"adjusted_retail_avg": 6575
},
"retail_rough": {
"base_retail_rough": 5050,
"mileage_retail_rough": 0,
"add_deduct_retail_rough": 0,
"regional_retail_rough": 25,
"adjusted_retail_rough": 5075
},
"trade_in_clean": {
"base_trade_in_clean": 5055,
"mileage_trade_in_clean": 0,
"add_deduct_trade_in_clean": 0,
"regional_trade_in_clean": 25,
"adjusted_trade_in_clean": 5080
},
"trade_in_avg": {
"base_trade_in_avg": 3705,
"mileage_trade_in_avg": 0,
"add_deduct_trade_in_avg": 0,
"regional_trade_in_avg": 25,
"adjusted_trade_in_avg": 3730
},
"trade_in_rough": {
"base_trade_in_rough": 2205,
"mileage_trade_in_rough": 0,
"add_deduct_trade_in_rough": 0,
"regional_trade_in_rough": 25,
"adjusted_trade_in_rough": 2230
},
"region2": 50,
"region3": 25,
"region4": -25,
"region5": 0,
"region6": 0,
"msrp": 17600,
"retail_equipped": 18820,
"price_includes": "AC",
"wheel_base": 106.3,
"tire_size": "195/65R15",
"seat_cap": "5",
"fuel_type": "Gas",
"fuel_cap": "13.2",
"fuel_delivery": "MPI",
"hwy_mpg": "38",
"city_mpg": "29",
"engine_description": "2.0L I-4 MPI DOHC ",
"cylinders": "4",
"engine_displacement": "2.0L",
"base_hp": "147 @ 6200",
"taxable_hp": 16.7,
"torque": "132 @ 4500",
"drivetrain": "FWD",
"num_gears": "6",
"ext_doors": "4",
"airbags": "Side Curtain",
"anti_corrosion_warranty": "5-year/100,000-mile, Limited",
"basic_warranty": "5-year/60,000-mile, Limited",
"road_assist_warranty": "5-year/60,000-mile",
"add_deduct_list": [
{
"uoc": "05",
"name": "w/o Auto Trans",
"xclean": -550,
"clean": -550,
"avg": -550,
"rough": -550,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}
],
"model_number_list": [
"C3421",
"C3422"
],
"mileage_list": [
{
"model_year": "2017",
"range_begin": 1,
"range_end": 8000,
"xclean": 2800,
"clean": 3000,
"avg": 3200,
"rough": 3200,
"finadv": 2900,
"mileage_cat": "B"
},
{
"model_year": "2017",
"range_begin": 110001,
"range_end": 113000,
"xclean": -250,
"clean": -125,
"avg": 0,
"rough": 125,
"finadv": -175,
"mileage_cat": "B"
},
{
"model_year": "2017",
"range_begin": 214001,
"range_end": 999999,
"xclean": -3325,
"clean": -3325,
"avg": -3325,
"rough": -3225,
"finadv": -3325,
"mileage_cat": "B"
}
],
"retail": 6550,
"trade_in": 5055,
"rough_trade_in": 2205,
"average_trade_in": 3705,
"loan_value": 8575,
"trade_in_values": [],
"auction_values": {
"low_auction_value": 2300,
"average_auction_value": 3600,
"high_auction_value": 4950,
"date_range": "8/29/2025"
}
}{
"success": false,
"message": "Missing vin (vehicle identification number)"
}{
"success": false,
"message": "Missing API key"
}{
"success": false,
"message": "No data found for this VIN"
}{
"success": false,
"message": "API usage limit exceeded",
"usage": {
"current": 1000,
"limit": 1000,
"remaining": 0
}
}{
"success": false,
"message": "Internal server error"
}{
"success": false,
"message": "Cannot access the internet at this time"
}