True Market Value

The True Market Valuetm (TMV) Repository provides True Market Valuetm information for a given vehcile by region.

TMV is the average price that a car sells for within a particular region. TMV is adjusted for options, the vehicle's color and associated incentives. TMV figures are based on the actual sales of other vehicles of its kind in the given region. The figure is then adjusted further for accuracy using sophisticated calculations designed by mathematicians at Edmunds.com.

Go to:

Please read the API Documentation page for information that applies to all our APIs

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/{method}

Response Formattop

{
    "tmv": {
        "colorAdjustment": [object],
        "destinationCharge": [integer],
        "estimatedTmv": [boolean],
        "gasGuzzlerTax": [integer],
        "incentivesAndRebates": [integer],
        "nationalBasePrice": [PriceObject],
        "offerPrice": [integer],
        "optionTMVPrices": [object],
        "regionalAdjustment": {object],
        "totalWithOptions": [PriceObject]
    }
}

Note that the totalWithOptions procing object includes all adjustments including mileage and condition. A PriceObject is:

{
    "baseInvoice": [integer],
    "baseMSRP": [integer],
    "tmv": [integer]
}

The properties of the PriceObject are:

  • baseInvoice: The invoice price
  • baseMSRP: The MSRP price
  • tmv: The TMVtm price

Sample Requesttop

http://api.edmunds.com/{version}/api/tmv/tmvservice/calculatenewtmv?api_key={api key}&styleid=101054138&zip=90404&optionid=101054153&optionid=101054154&fmt=json

Sample Response

{
    "tmv": {
        "colorAdjustment": {
            "tmv": 0
        },
        "destinationCharge": 815,
        "estimatedTmv": false,
        "gasGuzzlerTax": 0,
        "incentivesAndRebates": 0,
        "nationalBasePrice": {
            "baseInvoice": 34093,
            "baseMSRP": 36860,
            "tmv": 33721
        },
        "offerPrice": 34000,
        "optionTMVPrices": {},
        "regionalAdjustment": {
            "tmv": 391
        },
        "totalWithOptions": {
            "baseInvoice": 34908,
            "baseMSRP": 37675,
            "tmv": 34927
        }
    }
}

Special Requirementstop

When you display our True Market Value® (TMV®) prices for any new or used vehicles, we ask for the following:

  • When a price is displayed, it is captioned or titled one of the following: 
    • Edmunds.com True Market Value®
    • Edmunds.com TMV®
  • When a price is displayed, the date it was generated though the API should also be displayed, since TMV® prices are “perishable.”
  • That you include the following explanation of what that number is:

For the presentation of TMV® for new vehicles:

The Edmunds.com TMV® (Edmunds.com True Market Value®) price is Edmunds.com’s determination of the current average base dealer price in the area indicated by the Zip Code provided, unadjusted for vehicle color or any options. (If no Zip Code was provided, this price is the national price.)

For the presentation of TMV for used vehicles (using the appropriate bracketed words):

The Edmunds.com TMV® (Edmunds.com True Market Value®) price is Edmunds.com’s determination of the current average base [“dealer retail”] [“private party”] [“dealer trade-in”] price in the area indicated by the Zip Code provided, unadjusted for color or any options.  (If no Zip Code was provided, this price is the national price.)

  • That you include the following legal notice:

TMV® prices are copyrighted by Edmunds.com, Inc., which reserves all rights. Edmunds®, Edmunds.com True Market Value® and TMV® are registered trademarks of Edmunds.com, Inc. Edmunds.com, Inc. is not affiliated with this website or app. 

Available Methodstop

MethodDescription
calculatenewtmv

Get the True Market Valuetm for a particular new vehicle

calculateusedtmv

 Get the True Market Valuetm for a particular used vehicle
calculatetypicallyequippedusedtmv Get the True Market Valuetm for a typically equipped used vehicle
findcertifiedpriceforstyle Get the Certified Price for a particular vehicle by style ID
findcpoyearsbymake Get the Certified Pre-Owned years for a specific vehicle Make ID

 

Method: calculatenewtmv

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/calculatenewtmv?styleid=xxx&colorid=xxx&zip=xxx&optionid=xxxx&api_key=xxxxx&fmt=json

Parameters

Name and Description Required?

styleid

The Style ID of a vehicle

 Yes

zip

The four-digit zipcode of interest

 Yes

colorid

The vehicle color ID

 No
optionid

The vehicle option ID

 No

Method: calculateusedtmv

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/calculateusedtmv?styleid=xxx&condition=xxxxx&mileage=xxxx&colorid=xxx&zip=xxx&optionid=xxxx&api_key=xxxxx&fmt=json

Parameters

Name and Description Required?

styleid

The Style ID of a vehicle

 Yes
condition

The condition of the vehicle (Outstanding, Clean, Average, Rough, Damaged)

 Yes

mileage

How many miles has the car run?

 Yes

zip

The four-digit zipcode of interest

 Yes

colorid

The vehicle color ID

 No
optionid

The vehicle option ID

 No

Method: calculatetypicallyequippedusedtmv

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/calculatetypicallyequippedusedtmv?styleid=xxx&zip=xxx&api_key=xxxxx&fmt=json

Parameters

Name and Description Required?

styleid

The Style ID of a vehicle

 Yes

zip

The five-digit zipcode of interest

 Yes

Method: findcertifiedpriceforstyle

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/findcertifiedpriceforstyle?styleid=xxx&zip=xxx&api_key=xxxxx&fmt=json

Parameters

Name and Description Required?

styleid

The Style ID of a vehicle

 Yes

zip

The five-digit zipcode of interest

 Yes

Method: findcpoyearsbymake

URL

http://api.edmunds.com/{version}/api/tmv/tmvservice/findcpoyearsbymake?makeid=xxx&api_key=xxxxx&fmt=json

Parameters

Name and Description Required?

makeid

The vehicle Make ID

 Yes

version 25 as of 1 day ago by Ismail Elshareef

14 Comments

  1. greydude – 2 years ago

    It is unclear whether totalWithOptions already includes the adjustments for mileage, etc.

  2. Ismail Elshareef – 2 years ago

    Yes, the totalWithOptions includes adjustments for mileage and condition. Updated the docs to reflect that :)

    Thanks for taking the time to post this feedback. We appreciate it!

  3. Grant – 1 year ago

    What does the optionId represent for the calculatenewtmv and calculateusedtmv?

  4. Ismail Elshareef – 9 months ago

    Grant, sorry this is a bit late, but it looks like your comment fell through the cracks. Sorry.

    option IDs represent the equipment ID that you want to account for when calculating the TMV.

  5. michael09_09 – 8 months ago

    Steps to Find TMV & TCO from Edmundus API

    1) We use Edmunds VIN decoder api and get style id but instead of one we get more than one styleids some time for VIN we get more than 25 styleids.

    VIN Decoder api http://jsonviewer.stack.hu/#http://api.edmunds.com/v1/api/toolsrepository/vindecoder?vin=4T1BF1FK3CU031743&api_key=udqhaw8wyjfca4egdsf9fa6v&fmt=full_json

    2) To filter from this styleids we used VIN pattern but then also we are getting more than one styleids

    You can VIN pattern detail on: http://vin.dataonesoftware.com/vin_basics_blog/bid/103857/Squish-Stub-Pattern-Explosion-15-common-VIN-data-terms-defined

    3) To further filter best match we can use COLORID and OPTIONID of the vehicle but we have this information in descriptive way in database and we are not able to find mapping logic of it with Edmunds colorid and optioneid. For example we have color in database “Attitude Black Metallic” and Options in database are
    1> 6-Speed Automatic 2> Front wheel drive 3> 4-way adjustable front passenger seat 4> Adjustable front & rear headrests 5> Front sliding center armrest But there is no way we can map them to Edmunds colorid and optioneid, how we can do it?

    The main problem we are facing is not getting single styleid from vin decoder so, either help us to find how we can get it or let us know how we will get best match styleid from styleids returned through vin decoder api of Edmunds. We got stuck here can you please help us.

  6. Jawaad – 8 months ago

    Where am I supposed to obtain the colorid and optionid? I'm trying to call calculateusedtmv with all parameters.

    I've been able to get the information I want without the colorid and optionid, but I'd like to pass these values in to get even better results.

    As an example, if I'm trying to look up a Silver Honda Accord LX Sedan 5M, I've been able to call /vehicle/honda/accord/2002 to get other information such as styleid; however, I can't find the colorid anywhere.

    I've tried calling /vehicle/modelyearrepository/findmodelyearsbymakemodel, /vehicle/modelrepository/findbyid, and /vehicle/stylerepository/findbyid.

    Any help please? Thanks.

  7. michael09_09 – 8 months ago

    Ismail - it seems jawaad and us are having same issues. could you  please reply, or let us know with whom we can speak/email/call?"

  8. Ismail Elshareef – 8 months ago

    Colors and options are listed under "StandardEquipment" and "OptionalEquipment" in the Style object. You have to parse all equipment links to find out which is which.

  9. Ismail Elshareef – 8 months ago

    Alternatively, you could use this API call: http://api.edmunds.com/v1/api/vehicle/styleconfig/[STYLE ID]/?fmt=full_json&api_key=xxx and look under the featureMap object.

    We're working on simplifying this entire interface to make the data easily accessible.

  10. Suseenthar – 2 months ago

    Hi ,

    I am getting Null base-price , while using calculateusedtmv..

    http://api.edmunds.com/v1/api/tmv/tmvservice/calculateusedtmv?api_key=2tha6t53xhbkd3jc4fqtj8un&styleid=101054138&zip=90404&mileage=25000&fmt=json&condition=Outstanding

    i used all all condition with different style id too ..

    Kindly help me regarding this issue .. thanks

  11. Ismail Elshareef – 2 months ago

    Hi,

    We don't have pricing information on all styles. When you receive Null, that means we don't have a TMV for this particular vehicle.

    Thanks!

  12. yaymx5 – 1 day ago

    "zip: The four-digit zipcode of interest"

    Perhaps this should be five-digit? :)

  13. Ismail Elshareef – 1 day ago

    Yes, of course :) Thanks for the typo alert. Between "Year" and Zipcode fields, my brain is playing tricks on me.

    Cheers, Ismail

  14. Ismail Elshareef – 1 day ago

    Yes, of course :) Thanks for the typo alert. Between "Year" and Zipcode fields, my brain is playing tricks on me.

    Cheers, Ismail

Please sign in to post a comment.