Car Utils Overview
README
FREE resources for checking VIN, getting the market value of your car, estimating the cost of ownership in US, checking fuel economy, and more to come.
API Documentation
GET /marketvalue
Estimate market value of the car with specified VIN.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
vin | query | string | true | Vehicle identification number. Incomplete VIN checking is supported. |
mileage | query | integer | false | Current mileage of the car. If unspecified, an estimate will be used. |
Example responses
{
"vin": "5N3AA08D68N901917",
"vehicle": "2008 Infiniti QX56 Base",
"mean": 21123.48,
"stdev": 2108,
"count": 269,
"mileage": 50000,
"certainty": 99,
"period": [
"2022-01-23",
"2022-10-29"
],
"prices": {
"average": 21123.48,
"below": 19015.28,
"above": 23231.68,
"distribution": [
{
"group": {
"min": 4900,
"max": 6955,
"count": 27
}
},
...
]
},
"adjustments": {
"mileage": {
"average": 164807.99,
"input": 50000,
"adjustment": 11480
}
}
}
GET /ownershipcost
Estimate how much you will spend on the car with specified VIN for the next 5 years.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
vin | query | string | true | Vehicle identification number. Incomplete VIN checking is supported. |
mileage_start | query | integer | false | Start mileage of the car. If unspecified, an estimate will be used. |
mileage_year | query | integer | false | An estimate of many miles you will drive every year for the next 5 years. Defaults to 15000. |
Example responses
{
"vin": "5N3AA08D68N901917",
"mileage_start": 50000,
"mileage_year": 15000,
"vehicle": "2008 Infiniti QX56 Base",
"depreciation_cost": [
3053,
...
],
"insurance_cost": [
1671,
...
],
"fuel_cost": [
2600,
...
],
"maintenance_cost": [
2763,...
],
"repairs_cost": [
977,
...
],
"fees_cost": [
1080,
...
],
"total_cost": [
12144,
...
],
"total_cost_sum": 49297,
"5yr_mileage": 75000,
"cost_per_mile": 0.6572933333333333
}
GET /vindecoder
Decode VIN, get valuable information for the car you are interested in.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
vin | query | string | true | Vehicle identification number. Incomplete VIN checking is supported. |
Example responses
{
"vin": "5N3AA08D68N901917",
"errors": [
"0 - VIN decoded clean. Check Digit (9th position) is correct"
],
"specs": {
"abs": "Standard",
"body_class": "Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)",
"bus_floor_config_type": "Not Applicable",
...
}
}
GET /makes
Get all supported vehicle makes.
Parameters
None.
Example responses
[
"AM General",
"ASC Incorporated",
"Acura",
...
]
GET /models
Get all supported vehicle models for specified make.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
make | query | string | true | The brand of the vehicle. |
Example responses
[
"Chiron",
"Chiron Pur Sport",
"Chiron Super Sport",
"Divo",
"Veyron"
]
GET /fueleconomy
Get fuel economy information from the official U.S. government source.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
make | query | string | true | The vehicle make. Use /makes endpoint to get supported makes. |
model | query | string | true | The vehicle model. Use /models endpoint to get supported models for the specified make. |
Example responses
[
{
"city_mpg": 9,
"combined_mpg": 11,
"cylinders": 16,
"engine_displacement_liters": 8,
"drive_axle_type": "All-Wheel Drive",
"fuel_type": "Premium",
"highway_mpg": 14,
"make": "Bugatti",
"model": "Chiron",
"transmission": "Automatic (AM-S7)",
"vehicle_size_class": "Two Seaters",
"model_year": 2023
}
]