CAcarsxe
Market Value

Vehicle Market Value (v2)

Changed on

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 to apply the matching band's condition column to every mileage_* tier automatically; condition is optional and does not gate those adjustments. Otherwise apply bands yourself. Optional state selects the regional adjustment.

Credit plans: 25 credits per successful billable lookup. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md for billing units.

get/v2/marketvalue

Request

Query parameters

vinstring required

The 17 character long vehicle identification number.

statestring

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

mileagenumber

The current odometer reading (miles in the US, kilometers in Canada). When provided, the matching mileage_list band's condition column is written into every mileage_* tier, then adjusted_* is recalculated. condition is not required. Omit mileage to apply bands yourself.

condition'excellent' | 'clean' | 'average' | 'rough'

Optional. Overall condition: excellent, clean, average, or rough. excellent maps to the xclean response tier. Echoed in input when provided. Does not gate mileage adjustments.

Response

Market value retrieved.

uidstring

Valuation record identifier.

publish_datestring

Provider valuation publish date.

data_freqstring

Refresh frequency. D means daily.

statestring
countrystring
uvcstring

Unique vehicle code.

group_numstring
model_yearstring
makestring
modelstring
seriesstring
stylestring
mileage_catstring
class_codestring
class_namestring
description_scorestring
first_values_flagboolean
risk_scorestring
whole_xcleanobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

whole_cleanobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

whole_avgobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

whole_roughobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

retail_xcleanobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

retail_cleanobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

retail_avgobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

retail_roughobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

trade_in_cleanobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

trade_in_avgobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

trade_in_roughobject

Condition valuation object. Nested keys are prefixed with the family and condition, for example base_retail_clean, mileage_retail_clean, add_deduct_retail_clean, regional_retail_clean, and adjusted_retail_clean. adjusted_* = base_* + mileage_* + add_deduct_* + regional_*.

region2number

Raw regional adjustment for region 2.

region3number

Raw regional adjustment for region 3.

region4number

Raw regional adjustment for region 4.

region5number

Raw regional adjustment for region 5.

region6number

Raw regional adjustment for region 6.

msrpnumber
retail_equippednumber
price_includesstring
wheel_basenumber
tire_sizestring
gvwnumber
payload_capnumber
seat_capstring
seatsstring
fuel_typestring
fuel_capstring
fuel_deliverystring
hwy_mpgstring
city_mpgstring
engine_descriptionstring
cylindersstring
engine_displacementstring
engine_turbochargedstring
base_hpstring
taxable_hpnumber
torquestring
oil_capstring
transmissionstring
drivetrainstring
num_gearsstring
ext_doorsstring
navigationstring
airbagsstring

Airbag configuration.

anti_corrosion_warrantystring

Corrosion / rust warranty.

basic_warrantystring
road_assist_warrantystring

Roadside-assistance warranty.

model_number_liststring[]
retailnumber

Typical retail asking value (base_retail_avg).

trade_innumber

Typical clean trade-in value (base_trade_in_clean).

rough_trade_innumber

Rough-condition trade-in value.

average_trade_innumber

Average-condition trade-in value.

loan_valuenumber

Typical loan / finance value (base_retail_clean).

Changes

  • ed8f6c024239Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • e0ce48cea6a6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status