Api documentation

Api documentation

Get TMV® Price for a Typically Equipped Used Car

Price: True Market Value
 
 
v1
 
 

Response format

{
    "tmv": {
        "nationalBasePrice": {price object},
        "optionTMVPrices": {price object},
        "regionalAdjustment": {price object},
        "colorAdjustment": {price object},
        "destinationCharge": {float},
        "regionalAdFee": {float},
        "totalWithOptions": {price object},
        "incentivesAndRebates": {float},
        "offerPrice": {float},
        "certifiedUsedPrice": {float},
        "conditionAdjustment": {price object},
        "mileageAdjustment": {price object},
        "predictedChange": null,
        "predictedChangeIndicator": null,
        "gasGuzzlerTax": {float},
        "estimatedTmv": {boolean}
    }
}
Property Description Visibility
nationalBasePrice The national TMV® price for the base trim of this vehicle Edmunds, Partners, Public
optionTMVPrices The TMV® price for all option adjustments when applicable Edmunds, Partners, Public
regionalAdjustment The TMV® price for the regional adjustment when applicable Edmunds, Partners, Public
colorAdjustment The TMV® price for all color adjustments when applicable Edmunds, Partners, Public
regionalAdFee The ad fee price when applicable Edmunds, Partners, Public
totalWithOptions The total TMV® price including all adjustments Edmunds, Partners, Public
incentivesAndRebates All incentives and rebated related to this vehicle Edmunds, Partners, Public
offerPrice Edmunds.com special price offer Edmunds, Partners, Public
certifiedUsedPrice The TMV® price for the certified vehicle when application Edmunds, Partners, Public
mileageAdjustment The TMV® price for the mileage adjustment when applicable Edmunds, Partners, Public
predictedChange The TMV® price for the mileage adjustment when applicable Edmunds, Partners, Public
predictedChangeIndicator The TMV® price for the mileage adjustment when applicable Edmunds, Partners, Public
gasGuzzlerTax The gas guzzler tax Edmunds, Partners, Public
estimatedTmv Is the TMV® value estimated or accurate? Edmunds, Partners, Public

The price object has this format:

{
    "baseMSRP": null,
    "baseInvoice": null,
    "deliveryCharges": null,
    "tmv": -105.0,
    "usedTmvRetail": null,
    "usedPrivateParty": null,
    "usedTradeIn": null,
    "estimateTmv": null,
    "tmvRecommendedRating": null
}
Property Description Visibility
baseMSRP The base MSRP price for this vehicle (for new cars only) Edmunds, Partners, Public
baseInvoice The base invoice price for this vehicle (for new cars only) Edmunds, Partners, Public
deliveryCharges Delivery charge (for new cars only) Edmunds, Partners, Public
tmv The TMV® price (for new cars only) Edmunds, Partners, Public
usedTmvRetail The TMV® price (for used cars only) Edmunds, Partners, Public
usedPrivateParty The TMV® price for selling the car privately (for used cars only) Edmunds, Partners, Public
usedTradeIn The TMV® price for trading the car in at the dealership (for used cars only) Edmunds, Partners, Public
estimateTmv Is the TMV® value estimated or accurate? Edmunds, Partners, Public
tmvRecommendedRating deprecated Edmunds, Partners, Public