Discover comprehensive vehicle market value including historical vehicle sale history. Learn more about above and below market pricing.
The Vehicle Market Value API provides access to a library of vehicle market value data.
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 CarsXE's sales database.
With the assumption that sale prices are normally distributed, CarsXE's market value model estimates the "below market" and "above market" values within a distribution.
This endpoint allows you to retrieve the market value for a specific vehicle based on its VIN.
keyYour CarsXE API key.
vinThe 17 character long vehicle identification number.
stateThe US state of the vehicle to get the market value for.
mileageThe current mileage of the vehicle used to adjust the market value. Must be a valid numeric value.
conditionThe overall condition of the vehicle. Accepted values are:
excellent, clean, average, or rough.
uidA unique identifier for for the vehicle.
inputA map of the input: "vin", "state", "country" of the vehicle.
publish_dateThe date when the vehicle market value data was last published or updated.
data_freqThe frequency of data updates. It indicates that the market value data provided by the API is updated once per day.
stateThe state where the vehicle's market value is being assessed, in this case, California.
countryThe country context for the valuation, in this case, the United States.
uvcThe unique vehicle code. It is a unique identifier assigned to a specific vehicle configuration or model. This code helps in accurately identifying and retrieving precise market value data for that particular vehicle.
group_numA group identifier used to classify or associate the vehicle with a specific category, market segment, or data grouping. e.g., sedans, SUVs.
model_yearThe manufacturing year of the vehicle model being assessed. This information is crucial as it directly impacts the vehicle's market value, reflecting depreciation, demand, and historical relevance in pricing calculations.
makeThe brand or manufacturer of the vehicle, in this case, Lexus.
modelThe model of the vehicle, which is a particular version of the Lexus brand, here being the RX 350.
seriesThe series associated with the vehicle.
styleDescribes the vehicle style or body type. In this case:
mileage_catA category for the vehicle's mileage, could represent a specific mileage range or classification.
class_codeA class code that categorizes the vehicle into a specific segment or type.
class_nameThis is a human-readable description of the vehicle's class. It specifies that the vehicle is categorized as a large luxury crossover/SUV, helping to describe the vehicle's type or market segment.
description_scoreA rating or score based on the vehicle's description quality or completeness.
first_values_flagIndicates whether the vehicle's market value data is the first set of values being used or provided. In this case, it's set to false, meaning the data may not be the initial set or it has been updated or revisited.
risk_scoreA risk score associated with the vehicle's market value or condition. A risk score might assess factors such as potential for accidents, fraud, or reliability concerns.
whole_xcleanExcellent condition, typically with no significant wear.
whole_cleanGood condition, with minor wear.
whole_avgAverage condition, showing moderate wear.
whole_roughPoor condition, showing significant wear or issues.
For each category (e.g., "whole_xclean"), there are further subfields:
retail_xcleanThe retail price of a vehicle in excellent condition (no significant wear, like new or almost new).
retail_cleanThe retail price for a vehicle in good condition (minor wear and tear, but well-maintained).
retail_avgThe retail price of a vehicle in average condition (moderate wear, typically for a used vehicle).
retail_roughThe retail price for a vehicle in poor condition (significant wear and tear, possible mechanical or cosmetic issues).
trade_in_cleanThe trade-in price for a vehicle in good condition (minor wear and tear, well-maintained, ready for resale or continued use).
trade_in_avgThe trade-in price for a vehicle in average condition (moderate wear, typical for a used vehicle with normal signs of use).
trade_in_roughThe trade-in price for a vehicle in poor condition (significant wear, potential mechanical or cosmetic issues, or higher depreciation).
msrpManufacturer’s Suggested Retail Price (MSRP) is the recommended selling price set by the vehicle manufacturer for the vehicle before any dealer discounts or additions. It is often used as a starting point for pricing.
retail_equippedThe retail price of the vehicle equipped with all available options and features, including any add-ons, upgrades, or packages.
price_includesThis describes the options or features that are included in the vehicle’s price. It lists the additional equipment or features that are part of the specified price.
wheel_baseThe wheelbase is the distance (106.9 inches) between the front and rear axles of the vehicle. It can affect the vehicle's handling, ride quality, and interior space.
tire_sizeThe tire size indicates the dimensions of the tires installed on the vehicle. This includes:
gvwGross Vehicle Weight (GVW) is the total weight (5,245 pounds) of the vehicle, including its maximum load (passengers, cargo, etc.).
seat_capThe seating capacity indicates the number of passengers the vehicle can accommodate.
fuel_typeThe type of fuel the vehicle uses.
fuel_capThe fuel capacity refers to the volume of fuel the vehicle's tank can hold, usually in gallons.
fuel_deliveryFuel delivery system type used by the vehicle. MPI stands for Multi-Point Fuel Injection, which is a type of fuel injection system where each cylinder has its own injector, allowing more precise control of fuel delivery.
hwy_mpgHighway Miles Per Gallon (MPG) represents the vehicle's fuel efficiency on highways or at constant speeds.
city_mpgCity Miles Per Gallon (MPG) indicates the vehicle’s fuel efficiency in urban or stop-and-go driving conditions.
engine_descriptionThis field provides a description of the vehicle’s engine.
cylindersThe number of cylinders in the engine.
engine_displacementThe engine displacement refers to the total volume of all the cylinders in the engine, often measured in liters.
base_hpThe base horsepower of the engine, which measures its maximum power output.
taxable_hpThe taxable horsepower refers to the engine’s power rating used for tax or registration purposes, which might be calculated differently from the base horsepower.
torqueThe engine’s torque is a measure of its rotational force, important for acceleration and towing capacity.
transmissionThe type of transmission the vehicle uses. The vehicle has an automatic transmission, as indicated by "A".
drivetrainThe vehicle’s drivetrain indicates how power is delivered to the wheels. The vehicle has All-Wheel Drive (AWD), meaning power is distributed to all four wheels for better traction, especially in poor road conditions.
num_gearsThe number of gears in the vehicle's transmission.
ext_doorsThe number of exterior doors the vehicle has. The vehicle has 4 doors, which is typical for a sedan or a 4-door SUV.
basic_warrantyThe basic warranty for the vehicle, covering repairs or defects within a specified time or mileage limit.
add_deduct_listRepresents a list of additions or deductions based on specific options or features in the vehicle, and how those features impact its market value.
model_number_listThis is a list of model numbers associated with the vehicle.
mileage_listRepresents a list of additions or deductions based on mileage / kilometer range (US / Canada) at the vehicle’s respective condition.
retailThe retail value of the vehicle, which represents the expected price if the vehicle is sold to a consumer, typically by a dealership.
trade_inThe trade-in value of the vehicle, which is how much a dealership would offer to accept the vehicle as a trade-in for purchasing a different vehicle.
rough_trade_inThe rough trade-in value of the vehicle, which represents the lowest price a dealership would offer for a vehicle in poor condition (rough).
average_trade_inThe average trade-in value, which represents a middle ground or average trade-in price for a vehicle in average condition.
loan_valueThe loan value of the vehicle, which is the estimated amount the vehicle would be financed for, typically used by banks or financial institutions for vehicle loans.
trade_in_valuesThis field would typically contain additional details related to trade-in values over time or across different conditions.
auction_valuesThe auction values represent the price range that the vehicle could sell for at an auction, which is typically lower than retail but higher than trade-in values. Auction prices depend on the vehicle's condition and demand.
curl -G https://api.carsxe.com/v2/marketvalue \
-d key=CARSXE_API_KEY \
-d vin=WBAFR7C57CC811956{
"uid": "FDE60872",
"input": {
"vin": "WBAFR7C57CC811956",
"country": "US"
},
"publish_date": "4/8/2025",
"data_freq": "D",
"state": "NT",
"country": "US",
"uvc": "2012100134",
"group_num": "4265",
"model_year": "2012",
"make": "BMW",
"model": "5-Series",
"series": "535i",
"style": "4D Sedan",
"mileage_cat": "G",
"class_code": "F",
"class_name": "Luxury Car",
"description_score": "",
"first_values_flag": false,
"risk_score": "",
"whole_xclean": {
"base_whole_xclean": 6500,
"mileage_whole_xclean": 0,
"add_deduct_whole_xclean": 0,
"regional_whole_xclean": 0,
"adjusted_whole_xclean": 6500
},
"whole_clean": {
"base_whole_clean": 5300,
"mileage_whole_clean": 0,
"add_deduct_whole_clean": 0,
"regional_whole_clean": 0,
"adjusted_whole_clean": 5300
},
"whole_avg": {
"base_whole_avg": 3675,
"mileage_whole_avg": 0,
"add_deduct_whole_avg": 0,
"regional_whole_avg": 0,
"adjusted_whole_avg": 3675
},
"whole_rough": {
"base_whole_rough": 2100,
"mileage_whole_rough": 0,
"add_deduct_whole_rough": 0,
"regional_whole_rough": 0,
"adjusted_whole_rough": 2100
},
"retail_xclean": {
"base_retail_xclean": 10775,
"mileage_retail_xclean": 0,
"add_deduct_retail_xclean": 0,
"regional_retail_xclean": 0,
"adjusted_retail_xclean": 10775
},
"retail_clean": {
"base_retail_clean": 9325,
"mileage_retail_clean": 0,
"add_deduct_retail_clean": 0,
"regional_retail_clean": 0,
"adjusted_retail_clean": 9325
},
"retail_avg": {
"base_retail_avg": 6975,
"mileage_retail_avg": 0,
"add_deduct_retail_avg": 0,
"regional_retail_avg": 0,
"adjusted_retail_avg": 6975
},
"retail_rough": {
"base_retail_rough": 5150,
"mileage_retail_rough": 0,
"add_deduct_retail_rough": 0,
"regional_retail_rough": 0,
"adjusted_retail_rough": 5150
},
"trade_in_clean": {
"base_trade_in_clean": 5395,
"mileage_trade_in_clean": 0,
"add_deduct_trade_in_clean": 0,
"regional_trade_in_clean": 0,
"adjusted_trade_in_clean": 5395
},
"trade_in_avg": {
"base_trade_in_avg": 3770,
"mileage_trade_in_avg": 0,
"add_deduct_trade_in_clean": 0,
"regional_trade_in_clean": 0,
"adjusted_trade_in_clean": 5395
},
"trade_in_rough": {
"base_trade_in_rough": 2015,
"mileage_trade_in_rough": 0,
"add_deduct_trade_in_rough": 0,
"regional_trade_in_rough": 0,
"adjusted_trade_in_rough": 2015
},
"region2": 0,
"region3": 0,
"region4": -50,
"region5": 0,
"region6": 0,
"msrp": 52500,
"retail_equipped": 55375,
"price_includes": "AC AT LTH SR",
"wheel_base": 116.9,
"tire_size": "245/45R18",
"gvw": 3913,
"seat_cap": "5",
"fuel_type": "Gas",
"fuel_cap": "18.5",
"fuel_delivery": "Direct injection",
"hwy_mpg": "28",
"city_mpg": "19",
"engine_description": "3.0L I-6 DI DOHC T/C",
"cylinders": "6",
"engine_displacement": "3.0L",
"engine_turbocharged": "Turbocharg",
"base_hp": "306 @ 5800",
"taxable_hp": 26.3,
"torque": "400 @ 5000",
"transmission": "A",
"drivetrain": "RWD",
"num_gears": "6",
"ext_doors": "4",
"airbags": "Side Curtain; Supplemental Restraint System",
"basic_warranty": "4-year/50,000-mile, Limited",
"road_assist_warranty": "4-year/Unlimited-mile",
"add_deduct_list": [
{
"uoc": "N5",
"name": "Navigation System",
"xclean": 0,
"clean": 0,
"avg": 0,
"rough": 0,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
},
{
"uoc": "41",
"name": "Sport Package",
"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
},
{
"uoc": "MS",
"name": "M Sport Package",
"xclean": 600,
"clean": 600,
"avg": 600,
"rough": 600,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
},
{
"uoc": "05",
"name": "w/o Auto Trans",
"xclean": -650,
"clean": -650,
"avg": -650,
"rough": -650,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}
],
"model_number_list": [
"125C"
],
"mileage_list": [
{
"model_year": "2012",
"range_begin": 1,
"range_end": 9000,
"xclean": 2600,
"clean": 2750,
"avg": 2925,
"rough": 2925,
"finadv": 2675,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 9001,
"range_end": 21000,
"xclean": 2425,
"clean": 2600,
"avg": 2750,
"rough": 2925,
"finadv": 2500,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 21001,
"range_end": 33000,
"xclean": 2275,
"clean": 2425,
"avg": 2600,
"rough": 2750,
"finadv": 2350,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 33001,
"range_end": 45000,
"xclean": 2100,
"clean": 2275,
"avg": 2425,
"rough": 2600,
"finadv": 2175,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 45001,
"range_end": 57000,
"xclean": 1950,
"clean": 2100,
"avg": 2275,
"rough": 2425,
"finadv": 2025,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 57001,
"range_end": 69000,
"xclean": 1850,
"clean": 1950,
"avg": 2100,
"rough": 2275,
"finadv": 1900,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 69001,
"range_end": 81000,
"xclean": 1625,
"clean": 1850,
"avg": 1950,
"rough": 2100,
"finadv": 1725,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 81001,
"range_end": 88000,
"xclean": 1400,
"clean": 1625,
"avg": 1850,
"rough": 1950,
"finadv": 1500,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 88001,
"range_end": 95000,
"xclean": 1150,
"clean": 1400,
"avg": 1625,
"rough": 1850,
"finadv": 1275,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 95001,
"range_end": 102000,
"xclean": 925,
"clean": 1150,
"avg": 1400,
"rough": 1625,
"finadv": 1050,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 102001,
"range_end": 109000,
"xclean": 700,
"clean": 925,
"avg": 1150,
"rough": 1400,
"finadv": 825,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 109001,
"range_end": 116000,
"xclean": 600,
"clean": 700,
"avg": 925,
"rough": 1150,
"finadv": 650,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 116001,
"range_end": 123000,
"xclean": 500,
"clean": 600,
"avg": 700,
"rough": 925,
"finadv": 550,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 123001,
"range_end": 126000,
"xclean": 400,
"clean": 500,
"avg": 600,
"rough": 700,
"finadv": 450,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 126001,
"range_end": 129000,
"xclean": 300,
"clean": 400,
"avg": 500,
"rough": 600,
"finadv": 350,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 129001,
"range_end": 132000,
"xclean": 200,
"clean": 300,
"avg": 400,
"rough": 500,
"finadv": 250,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 132001,
"range_end": 135000,
"xclean": 100,
"clean": 200,
"avg": 300,
"rough": 400,
"finadv": 150,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 135001,
"range_end": 138000,
"xclean": 0,
"clean": 100,
"avg": 200,
"rough": 300,
"finadv": 50,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 138001,
"range_end": 141000,
"xclean": -100,
"clean": 0,
"avg": 100,
"rough": 200,
"finadv": -50,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 141001,
"range_end": 144000,
"xclean": -200,
"clean": -100,
"avg": 0,
"rough": 100,
"finadv": -150,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 144001,
"range_end": 147000,
"xclean": -300,
"clean": -200,
"avg": -100,
"rough": 0,
"finadv": -250,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 147001,
"range_end": 150000,
"xclean": -400,
"clean": -300,
"avg": -200,
"rough": -100,
"finadv": -350,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 150001,
"range_end": 153000,
"xclean": -500,
"clean": -400,
"avg": -300,
"rough": -200,
"finadv": -450,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 153001,
"range_end": 156000,
"xclean": -600,
"clean": -500,
"avg": -400,
"rough": -300,
"finadv": -550,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 156001,
"range_end": 159000,
"xclean": -700,
"clean": -600,
"avg": -500,
"rough": -400,
"finadv": -650,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 159001,
"range_end": 162000,
"xclean": -925,
"clean": -700,
"avg": -600,
"rough": -500,
"finadv": -825,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 162001,
"range_end": 165000,
"xclean": -1150,
"clean": -925,
"avg": -700,
"rough": -600,
"finadv": -1050,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 165001,
"range_end": 172000,
"xclean": -1400,
"clean": -1150,
"avg": -925,
"rough": -700,
"finadv": -1275,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 172001,
"range_end": 179000,
"xclean": -1625,
"clean": -1400,
"avg": -1150,
"rough": -925,
"finadv": -1500,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 179001,
"range_end": 186000,
"xclean": -1850,
"clean": -1625,
"avg": -1400,
"rough": -1150,
"finadv": -1725,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 186001,
"range_end": 193000,
"xclean": -2075,
"clean": -1850,
"avg": -1625,
"rough": -1400,
"finadv": -1950,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 193001,
"range_end": 200000,
"xclean": -2300,
"clean": -2075,
"avg": -1850,
"rough": -1625,
"finadv": -2200,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 200001,
"range_end": 207000,
"xclean": -2700,
"clean": -2300,
"avg": -2075,
"rough": -1850,
"finadv": -2500,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 207001,
"range_end": 214000,
"xclean": -2925,
"clean": -2700,
"avg": -2300,
"rough": -2075,
"finadv": -2825,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 214001,
"range_end": 226000,
"xclean": -3150,
"clean": -2925,
"avg": -2700,
"rough": -2300,
"finadv": -3050,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 226001,
"range_end": 238000,
"xclean": -3375,
"clean": -3150,
"avg": -2925,
"rough": -2700,
"finadv": -3275,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 238001,
"range_end": 250000,
"xclean": -3600,
"clean": -3375,
"avg": -3150,
"rough": -2925,
"finadv": -3500,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 250001,
"range_end": 262000,
"xclean": -3825,
"clean": -3600,
"avg": -3375,
"rough": -3150,
"finadv": -3725,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 262001,
"range_end": 274000,
"xclean": -3825,
"clean": -3825,
"avg": -3600,
"rough": -3375,
"finadv": -3825,
"mileage_cat": "G"
},
{
"model_year": "2012",
"range_begin": 274001,
"range_end": 999999,
"xclean": -3825,
"clean": -3825,
"avg": -3825,
"rough": -3600,
"finadv": -3825,
"mileage_cat": "G"
}
],
"retail": 6975,
"trade_in": 5395,
"rough_trade_in": 2015,
"average_trade_in": 3770,
"loan_value": 9325,
"trade_in_values": [],
"auction_values": {
"low_auction_value": 2100,
"average_auction_value": 3675,
"high_auction_value": 5300,
"date_range": "4/8/2025"
}
}