Total Cost of Ownership API
Comprehensive 5-year vehicle ownership cost analysis including depreciation, fuel, and maintenance
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.
Endpoint
GET https://api.auto.dev/tco/{vin}View in Browser
https://api.auto.dev/tco/WP0AF2A99KS165242?zip=90210&milesPerYear=12000Parameters
Path Parameters
| Prop | Type | Default |
|---|---|---|
vin | string | - |
Query Parameters
| Prop | Type | Default |
|---|---|---|
zip? | string | Auto-detected based on user location |
fromZip? | string | - |
Example Request
curl -X GET "https://api.auto.dev/tco/WP0AF2A99KS165242?zip=76548&fromZip=60695" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Response Structure
Example Response
{
"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
}
}
}
}Cost Component Analysis
The TCO calculation includes five main cost components:
- Depreciation - Vehicle value loss over time (largest cost factor)
- Fuel Costs - Based on EPA ratings and local fuel prices
- Financing Interest - Loan interest payments over ownership period
- Insurance - Annual insurance premiums based on vehicle and location
- Maintenance & Repairs - Scheduled maintenance and expected repairs
Use Cases
- Vehicle Purchase Decisions: Compare total ownership costs between different vehicles before buying
- Fleet Management: Evaluate long-term costs for fleet vehicle selection and budget planning
- Lease vs Buy Analysis: Calculate comprehensive costs to determine optimal vehicle acquisition strategy
Error Responses
Invalid Location
{
"status": 400,
"error": "Invalid ZIP code format. ZIP code must be 5 digits (e.g., 90210) or 5+4 format (e.g., 90210-1234)",
"code": "INVALID_LOCATION",
"path": "/tco/1GYKPDRSXSZ102995?zip=ABCDE",
"requestId": "d4e5f6g7h8i9j0k1"
}Invalid VIN
{
"status": 400,
"error": "VIN must be exactly 17 characters",
"code": "INVALID_VIN_FORMAT",
"path": "/tco/123Invalid",
"requestId": "a1b2c3d4e5f6g7h8"
}Interactive API Reference
Ready to test this endpoint? Use our interactive API playground to make live requests and see real responses.
Try Total Cost of Ownership API
Test this endpoint with your API key and explore live responses
Plan Availability
- Starter: ❌ Not available
- Growth: ✅ Available
- Scale: ✅ Available
See pricing for plan details and signup.
Was this API reference helpful?