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
}
]