docs / api / vin / vehicle-ownership

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. Based on millions of records in VinAudit’s historical vehicle database, the API supports estimating depreciation, insurance, fuel, maintenance, repairs, and state taxes & fees. Access to the ownership cost API requires an API account with ownership cost access enabled.

GET

http://ownershipcost.vinaudit.com/getownershipcost.php

Request Parameters

Parameter

vin

optional

Example

1NXBR32E85Z505904

Description

The vehicle identification number

Parameter

key

optional

Example

VA_DEMO_KEY

Description

Your VinAudit API key

Parameter

state

optional

Example

Description

State Code

Parameter

format

optional

Example

json

Description

Output format

Parameter	Description	Example
vinoptional	The vehicle identification number	1NXBR32E85Z505904
keyoptional	Your VinAudit API key	VA_DEMO_KEY
stateoptional	State Code	WA
formatoptional	Output format	json

Response Attributes

Field

vin

Example

1NXBR32E85Z505904

Description

The vehicle identification number

Field

mileage_start

Example

-1

Description

The current mileage of the vehicle (default value: -1)

Field

mileage_year

Example

15000

Description

The estimated yearly mileage of the vehicle (default value: 15000)

Field

vehicle

Example

2005 Toyota Corolla LE

Description

The vehicle title (Year, Make, Model, Trim)

Field

depreciation_cost

Example

1682, 807, 706, 639, 572

Description

The estimated yearly depreciation cost

Field

insurance_cost

Example

1487, 1539, 1592, 1648, 1706

Description

The estimated yearly insurance cost

Field

fuel_cost

Example

2722, 2803, 2887, 2974, 3063

Description

The estimated yearly fuel cost

Field

maintenance_cost

Example

2763, 1748, 845, 545, 2291

Description

The estimated yearly maintenance cost

Field

repairs_cost

Example

977, 1138, 1298, 1417, 1627

Description

The estimated yearly repairs cost

Field

fees_cost

Example

459, 52, 67, 43, 59

Description

The estimated yearly state fees & taxes cost

Field

total_cost

Example

10089, 8088, 7396, 7266, 9319

Description

The estimated yearly total cost

Field

total_cost_sum

Example

42158

Description

The estimated overall total cost over the next 5 years

Field	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

Example Request

HTTP

http://ownershipcost.vinaudit.com/getownershipcost.php?vin=1NXBR32E85Z505904&key=VA_DEMO_KEY&state=WA

Example Response

json

{
  "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
}