CA
US
Vehicle Ownership Cost API
The vehicle ownership cost API can estimate the cost of ownership over the next 5 years based on a vehicle’s VIN. Support by millions of records in VinAudit’s historical vehicle database, the API supports estimating depreciation, insurance, fuel, maintenance, repairs, and taxes & fees. Access to the ownership cost API requires an API account with ownership cost access enabled.
Documentation
To query whether data for a VIN exists, request:
http://ownershipcost.vinaudit.com/getownershipcost.php
With GET or POST parameters:
| Parameter | Description | Required | Example |
|---|---|---|---|
| vin | The vehicle identification number | Yes | 1NXBR32E85Z505904 |
| key | Your VinAudit API key | Yes | VA_DEMO_KEY |
| state | State Code | Yes | WA |
| format | Output format (json) | (optional) | json |
Response attributes:
| Parameter | Description | Example |
|---|---|---|
| vin | The vehicle identification number | 1NXBR32E85Z505904 |
| mileage_start | The current mileage of the vehicle (default value: -1) | -1 |
| mileage_year | The estimated yearly mileage of the vehicle (default value: 15000) | 15000 |
| vehicle | The vehicle title (Year, Make, Model, Trim) | 2005 Toyota Corolla LE |
| depreciation_cost | The estimated yearly depreciation cost | 1682, 807, 706, 639, 572 |
| insurance_cost | The estimated yearly insurance cost | 1487, 1539, 1592, 1648, 1706 |
| fuel_cost | The estimated yearly fuel cost | 2722, 2803, 2887, 2974, 3063 |
| maintenance_cost | The estimated yearly maintenance cost | 2763, 1748, 845, 545, 2291 |
| repairs_cost | The estimated yearly repairs cost | 977, 1138, 1298, 1417, 1627 |
| fees_cost | The estimated yearly state fees & taxes cost | 459, 52, 67, 43, 59 |
| total_cost | The estimated yearly total cost | 10089, 8088, 7396, 7266, 9319 |
| total_cost_sum | The estimated overall total cost over the next 5 years | 42158 |
Examples
Example #1. (successful request)
Request:
http://ownershipcost.vinaudit.com/getownershipcost.php?vin=1NXBR32E85Z505904&key=VA_DEMO_KEY&state=WA
Response:
{"vin":"1NXBR32E85Z505904","mileage_start":150000,"mileage_year":15000,"vehicle":"2005 Toyota Corolla","trim":"CE","depreciation_cost":[1682,807,706,639,572],"insurance_cost":[1487,1539,1592,1648,1706],"fuel_cost":[2722,2803,2887,2974,3063],"maintenance_cost":[2763,1748,845,545,2291],"repairs_cost":[977,1138,1298,1417,1627],"fees_cost":[599,21,21,21,21],"total_cost":[10230,8057,7350,7245,9281],"total_cost_sum":42164}Example #2. (unsuccessful request)
Request:
http://ownershipcost.vinaudit.com/getownershipcost.php?vin=MNXBR32E85Z505904&key=VA_DEMO_KEY&format=json
Response:
{"vin":"MNXBR32E85Z505904","success":false,"error":"invalid vin"}