Vehicle Market Value

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.

GET/marketvalue

Vehicle Market Value

This endpoint allows you to retrieve the market value for a specific vehicle based on its VIN.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
vin
Type
string
Description
The 17 character long vehicle identification number.

Optional attributes

Name
format
Type
string
Description
The format of the response. One of json or xml. Defaults to json.

Response attributes

Name
vin
Type
string
Description
The vehicle identification number.
Name
success
Type
boolean
Description
Whether market value data has been retrieved.
Name
retail
Type
string
Description
Retail price of the vehicle.
Name
tradeIn
Type
string
Description
The trade in price of the vehicle.
Name
roughTradeIn
Type
string
Description
The rough trade in price of the vehicle.
Name
averageTradeIn
Type
string
Description
The average trade in of the vehicle.
Name
loanValue
Type
string
Description
Loan value of vehicle.
Name
msrp
Type
string
Description
Manufacturer suggested retail price of vehicle.
Name
tradeInValues
Type
array
Description
A list of trade in values recorded for the vehicle.
Name
auctionValues
Type
object
Description
Map of auction value ranges in a given data range.

FAQ

Title
What VINs can I use for testing?
▼
You may be use the following VINs for test:
- JN1EV7AP6JM355294
- WBAFR7C57CC811956
Title
Is the Vehicle Market Value API included in the free trial?
▼
No, The Vehicle Market Value API is not included in the 7-day free trial. For more information visit our pricing page.

Request

GET

/marketvalue

curl -G https://api.carsxe.com/marketvalue \
  -d key=CARSXE_API_KEY \
  -d vin=WBAFR7C57CC811956

Response

{
    retail: "16075",
    tradeIn: "13575",
    roughTradeIn: "10250",
    averageTradeIn: "12050",
    loanValue: "12225",
    uid: 1172227,
    msrp: "52250",
    tradeInValues: [
      {
        date: "2018-08-01T00:00:00.000Z",
        value: "13575",
      },
      {
        date: "2018-07-01T00:00:00.000Z",
        value: "13600",
      },
      {
        date: "2018-06-01T00:00:00.000Z",
        value: "14175",
      },
      {
        date: "2018-05-01T00:00:00.000Z",
        value: "14175",
      },
      {
        date: "2018-04-01T00:00:00.000Z",
        value: "14650",
      },
    ],
    auctionValues: {
      lowAuctionValue: 9050,
      averageAuctionValue: 11925,
      highAuctionValue: 14825,
      dateRange: "8/6/2018 - 8/12/2018",
    },
  }