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