Market value

Vehicle Market Value (v2)

Get detailed market values for a VIN, including wholesale, retail and trade-in values across condition tiers, with optional adjustments for US state, mileage and condition.

Checking account...
GET
/v2/marketvalue

Get detailed market values for a VIN, including wholesale, retail and trade-in values across condition tiers, with optional adjustments for US state, mileage and condition.

Authorization

ApiKeyQuery
key<token>

Your CarsXE API key, passed as the key query parameter.

In: query

Query Parameters

vin*string

The 17 character long vehicle identification number.

state?string

The US state of the vehicle to get the market value for.

mileage?number

The current mileage of the vehicle used to adjust the market value. Must be a valid numeric value.

condition?string

The overall condition of the vehicle.

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": "FDE60872",
  "input": {
    "vin": "WBAFR7C57CC811956",
    "country": "US"
  },
  "publish_date": "4/8/2025",
  "state": "NT",
  "country": "US",
  "model_year": "2012",
  "make": "BMW",
  "model": "5-Series",
  "series": "535i",
  "style": "4D Sedan",
  "class_name": "Luxury Car",
  "whole_clean": {
    "base_whole_clean": 5300,
    "mileage_whole_clean": 0,
    "add_deduct_whole_clean": 0,
    "regional_whole_clean": 0
  },
  "retail_clean": {
    "base_retail_clean": 9325,
    "mileage_retail_clean": 0,
    "add_deduct_retail_clean": 0,
    "regional_retail_clean": 0
  }
}

{
  "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"
}