Get Total Cost of Ownership
Calculate comprehensive Total Cost of Ownership (TCO) for any vehicle over a 5-year period. Get detailed breakdowns of all ownership costs including depreciation, fuel, maintenance, repairs, insurance, taxes, and financing.
AuthorizationBearer <token>
Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY
In: header
Path Parameters
vinstring
17-character Vehicle Identification Number
Match
^[A-HJ-NPR-Z0-9]{17}$Query Parameters
zip?string
5-digit ZIP code for location-based calculations (insurance, taxes, fees)
Match
^[0-9]{5}(-[0-9]{4})?$fromZip?string
5-digit ZIP code for delivery/transport calculations
Match
^[0-9]{5}(-[0-9]{4})?$Response Body
curl -X GET "https://api.auto.dev/tco/string?zip=string&fromZip=string"{
"vehicle": {
"vin": "WP0AF2A99KS165242",
"year": 2019,
"make": "Porsche",
"model": "911",
"manufacturer": "Dr Ing HCF Porsch Ag"
},
"zip": "90210",
"tco": {
"total": {
"federalTaxCredit": 0,
"insurance": 12110,
"maintenance": 13788,
"repairs": 11874,
"taxesAndFees": 12164,
"financeInterest": 20657,
"depreciation": 44236,
"fuel": 25000,
"tcoPrice": 139829,
"averageCostPerMile": 1.86
},
"years": {
"1": {
"insurance": 2281,
"maintenance": 2006,
"repairs": 2038,
"taxesAndFees": 9728,
"financeInterest": 7077,
"depreciation": 13474,
"fuel": 4709,
"tcoPrice": 41313,
"averageCostPerMile": 1.86
},
"2": {
"insurance": 2349,
"maintenance": 147,
"repairs": 2195,
"taxesAndFees": 684,
"financeInterest": 5710,
"depreciation": 7566,
"fuel": 4850,
"tcoPrice": 23501,
"averageCostPerMile": 1.86
},
"3": {
"insurance": 2420,
"maintenance": 6898,
"repairs": 2364,
"taxesAndFees": 635,
"financeInterest": 4241,
"depreciation": 8510,
"fuel": 4996,
"tcoPrice": 30064,
"averageCostPerMile": 1.86
},
"4": {
"insurance": 2493,
"maintenance": 694,
"repairs": 2543,
"taxesAndFees": 579,
"financeInterest": 2663,
"depreciation": 6296,
"fuel": 5145,
"tcoPrice": 20413,
"averageCostPerMile": 1.86
},
"5": {
"insurance": 2567,
"maintenance": 4043,
"repairs": 2734,
"taxesAndFees": 538,
"financeInterest": 966,
"depreciation": 8390,
"fuel": 5300,
"tcoPrice": 24538,
"averageCostPerMile": 1.86
}
}
}
}{
"status": 400,
"error": "VIN must be exactly 17 characters",
"code": "INVALID_VIN_FORMAT",
"path": "/tco/123Invalid",
"requestId": "a1b2c3d4e5f6g7h8"
}