True Cost to Own

True Cost of Own is a calculated value derived from the Edmunds pricing system that describes the additional costs an automotive buyer may not have included when considering his or her vehicle purchase. These extra costs include: depreciation, interest on your loan, taxes and fees, insurance premiums, fuel costs, maintenance, and repairs.

Go to:

• URL
• Sample Request
• Special Requirements
• Available Methods

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

URL

http://api.edmunds.com/{version}/api/tco/{method}

Sample Requesttop

http://api.edmunds.com/v1/api/tco/getstyleswithtcodatabysubmodel?make=bmw&model=3series&year=2011&submodel=sedan&api_key=xxx&fmt=json

Sample Response

{
    "styles": {
        "328i 4dr Sedan (3.0L 6cyl 6M)": {
            "id": 101288737,
            "price": 34600,
            "styleLongName": "3.0L 6-cyl. 6-speed Manual",
            "trim": "328i"
        },
        "328i xDrive 4dr Sedan AWD (3.0L 6cyl 6M)": {
            "id": 101288738,
            "price": 36600,
            "styleLongName": "3.0L 6-cyl. AWD 6-speed Manual",
            "trim": "328i xDrive"
        },
        "335d 4dr Sedan (3.0L 6cyl Turbodiesel 6A)": {
            "id": 101288741,
            "price": 44150,
            "styleLongName": "3.0L 6-cyl. Turbodiesel 6-speed Automatic",
            "trim": "335d"
        },
        "335i 4dr Sedan (3.0L 6cyl Turbo 6M)": {
            "id": 101288739,
            "price": 42050,
            "styleLongName": "3.0L 6-cyl. Turbo 6-speed Manual",
            "trim": "335i"
        },
        "335i xDrive 4dr Sedan AWD (3.0L 6cyl Turbo 6M)": {
            "id": 101288740,
            "price": 44050,
            "styleLongName": "3.0L 6-cyl. Turbo AWD 6-speed Manual",
            "trim": "335i xDrive"
        }
    }
}

Special Requirementstop

When you display our True Cost to Own^® (TCO^®) data for any vehicles, we ask for the following:

• When data is displayed, it is captioned or titled one of the following: 
  • Edmunds.com True Cost to Own^®
  • Edmunds.com TCO^®

• When a data is displayed, the date it was generated though the API should also be displayed, since TCO^® prices are “perishable.”

• That you include the following explanation of what that number is:

Edmunds.com's True Cost to Own^® (TCO^®) is Edmunds.com’s estimate of the cost of buying and owning a vehicle for the first five years assuming 15,000 miles driven per year.  TCO^® includes depreciation, interest on financing, insurance premiums, taxes and fees, fuel, maintenance and repairs. 

• That you include the following legal notice:

TCO^® data are copyrighted by Edmunds.com, Inc., which reserves all rights. Edmunds^®, Edmunds.com True Cost to Own^® and TCO^® are registered trademarks of Edmunds.com, Inc. Edmunds.com, Inc. is not affiliated with this website or app. 

For legal reasons, we cannot expose the granular data (i.e. depreciation, taxes and fees, insurance, fuel, ...etc) that makes up the True Cost to Own value. If you want to get access to that data, please email us at api [at] edmunds [dot] com.

You can also send your users to the following URL for more information on the True Cost to Own value: http://www.edmunds.com/{make}/{model}/{year}/tco.html?style={styleid}&zip={zipcode}

Available Methodstop

Method: newtruecosttoownbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/newtruecosttoownbystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: usedtruecosttoownbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/usedtruecosttoownbystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: resalevaluesbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/resalevaluesbystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: depreciation/usedratesbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/depreciation/usedratesbystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: depreciation/newratesbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/depreciation/newratesbystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: newtotalcashpricebystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/newtotalcashpricebystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: usedtruecosttoownbystyleidandzip/{styleid}/{zip}

URL

http://api.edmunds.com/v1/api/tco/usedtotalcashpricebystyleidandzip/101287988/90019?api_key=xxx&fmt=json

Parameters

N/A

Method: getmakeswithtcodata

URL

http://api.edmunds.com/v1/api/tco/getmakeswithtcodata?api_key=xxx&fmt=json

Parameters

N/A

Method: getmodelswithtcodata

URL

http://api.edmunds.com/v1/api/tco/getmodelswithtcodata?makeid=xxx&api_key=xxx&fmt=json

Parameters

Method: getstyleswithtcodatabysubmodel

URL

http://api.edmunds.com/v1/api/tco/getstyleswithtcodatabysubmodel?make=xxx&model=xxx&year=xxx&submodel=xxx&makeyear=xxx&api_key=xxx&fmt=json

Parameters