VIN Decoder API Changelog

These logs document versioned changes to the Vincario API, and any products or services that rely on them.

To learn more about versions, please see each API documentation separately. For more information on upgrading to a newer version, please see our change log below.

Version	Date Introduced	Available Until
3.2	2022-10-18	To be determined
3.1	2020-04-22	2023-07-31
3.0	2019-04-29	2023-01-31
2.0	2016-04-02	2021-06-30
1.0	2013-02-16	2016-04-20

Data coverage improvement is an ongoing process that is happening continually throughout whole year.

API updates with inconsistent improvements leads to release of new API versions. Typically once a year.

In the following section you can see the Data Coverage per API version.

2025-07-13 Stolen Check API update

Country added:
- Italy

2025-06-20 For VIN Decode API, VIN Decode Info API & OEM VIN Lookup API endpoints

New parameter added:
- Make Logo (string)
  URL to the vehicle manufacturer's logo image.
  
  Example:
```
https://vincario.com/img/make/volvo.svg
```

2025-06-20 For Vehicle Market Value API endpoint

New parameter added:
- make_logo (string)
  URL to the vehicle manufacturer's logo image.
  
  Example:
```
https://vincario.com/img/make/volvo.svg
```

2025-03-18 Vehicle Market Value API update

New optional parameters added:
- odometer (integer)
  Returns vehicle price based on submitted odometer reading.
- odometer_unit (string)
  Unit of the odometer reading. Valid values are 'km' (kilometers) or 'mi' (miles). Default is km.
  
  Example:
```
price_odometer_adjusted": {
"odometer": 60000,
"odometer_unit": "km",
"price": 14648.88,
"price_currency": "EUR"
}
```

2024-02-23

Added API Endpoint:
- OEM VIN Lookup

2023-11-10 Vehicle Market Value API update

Parameters changed:
- price_mean (integer) → price_median (integer)
  The value was intended to be a median (and was computed as a median), but it was poorly named, which we have now fixed.
- odometer_mean (integer) → odometer_median (integer)
  The value was intended to be a median (and was computed as a median), but it was poorly named, which we have now fixed.

2023-08-28 VIN Decode API

New parameters added:
- version (string)
  Vehicle Version Code
  
  Example:
```
CM5957
```
- variant (string)
  Vehicle Variant Code
  
  Example:
```
CM59
```

2023-03-07 Vehicle Market Value API update

New parameters added:
- market (string)
  Country code (or Continent Code) of the market from which the data originates.
  
  Example:
```
DE
```
- vehicle_id (integer)
  Unique ID of vehicle's Make and Model combination.
  
  Example:
```
4599
```
- make_id (integer)
  Enum ID of Make.
  
  Example:
```
108
```
- model_id (integer)
  Enum ID of Model.
  
  Example:
```
18753
```
- transmission_id (integer)
  Enum ID of Transmission.
  
  Example:
```
2
```
- fuel_type_primary_id (integer)
  Enum ID of Primary Fuel.
  
  Example:
```
8
```

2022-10-18 Released API 3.2

Parameters changed:
- Front Breaks (string) → Front Brakes (string)
  Example:
```
Ventilated discs
```
- Rear Breaks (string) → Rear Brakes (string)
  Example:
```
Ventilated discs
```
- Maximum volume of Luggage (trunk) (integer) → Maximum Trunk Capacity (l) (integer)
  Example:
```
1686
```
- Minimum volume of Luggage (trunk) (integer) → Minimum Trunk Capacity (l) (integer)
  Example:
```
1130
```
- Minimum turning circle (turning diameter) (float) → Minimum Turning Circle (m) (float)
  Example:
```
11.9
```
- Engine Torque (integer) → Engine Torque (RPM) (integer)
  Example:
```
177
```
- Acceleration 0-100 km/h (float) → Acceleration 0-100 km/h (s) (float)
  Example:
```
8.2
```
- Fuel Capacity (float) → Fuel Capacity (l) (float)
  Example:
```
53
```
- Fuel Consumption l/100km (Combined) (float) → Fuel Consumption Combined (l/100km) (float)
  Example:
```
7.8
```
- Fuel Consumption l/100km (Extra Urban) (float) → Fuel Consumption Extra Urban (l/100km) (float)
  Example:
```
6.9
```
- Fuel Consumption l/100km (Urban) (float) → Fuel Consumption Urban (l/100km) (float)
  Example:
```
9.8
```
- CO2 Emission (integer) → CO2 Emission (g/km) (integer)
  Example:
```
289
```
- Engine Cylinder Bore (float) → Engine Cylinder Bore (mm) (float)
  Example:
```
76.5
```
- Engine Stroke (float) → Engine Stroke (mm) (float)
  Example:
```
95.5
```
New parameters added:
- Fuel Consumption Urban (l/100km) (WLTP) (float)
  Example:
```
2.8
```
- Average CO2 Emission (g/km) (float)
  Average CO2 Emission values across all vehicles sharing the same VIN structure.
  
  Example:
```
189.23
```
- CO2 Emission (g/km) (WLTP) (float)
  Example:
```
58
```
- Number Wheels (integer)
  Example:
```
4
```
- Brake System (string)
  Example:
```
Hydraulic
```
- Engine Manufacturer (string)
  Example:
```
PSA
```
- Engine Type (string)
  Example:
```
Electric Motor
```
- Suspension (string)
  Example:
```
Air suspension
```
- Electric Consumption (kWh/100km) (float)
  Example:
```
245.7
```
- Electric Consumption (kWh/100km) (WLTP) (float)
  Example:
```
215.2
```
- Electric Range From (km) (integer)
  Example:
```
384
```
- Electric Range From (km) (WLTP) (integer)
  Example:
```
285
```
- Electric Range To (km) (integer)
  Example:
```
410
```
- Electric Range To (km) (WLTP) (integer)
  Example:
```
310
```

2023-08-01

Deprecated all v3.1 endpoints

2021-08-06

Added API Endpoint:
- Vehicle Market Value

2021-01-22

Improved data coverage:
- Model Year (int)
  Significant improvement of Model Year Coverage.

2020-12-23

New parameter added:
- Number of Axles (int)
  Number of Axles
  
  Example:
```
2
```

2020-09-10

Parameters changed:
- Production Started (date) → Production Started (int)
  Year when the production of the vehicles of given model line was started.
  
  Example:
```
2014
```
- Production Stopped (date) → Production Stopped (int)
  Year when the production of the vehicles of given model line was ended.
  
  Example:
```
2018
```
New parameters added:
- ABS (int)
  If the vehicle is equipped with an ABS.
  
  Example:
```
1
```
- Max Speed (km/h) (int)
  Example:
```
250
```
- Max Weight (kg) (int)
  Technically permissible maximum weight.
  
  Example:
```
2330
```
- Max roof load (kg) (int)
  Example:
```
75
```
- Permitted towbar download (kg) (int)
  Example:
```
80
```
- Permitted trailer load with brakes 12% (kg) (int)
  Example:
```
1445
```
- Permitted trailer load without brakes (kg) (int)
  Example:
```
720
```

2020-04-22 Released API 3.1

Parameters changed:
- Model (string)
  Some vehicles share chassis across multiple models. In that case multiple models are returned.
  
  Example:
```
Bora, Jetta
```
- Number of Seats (int) → Number of Seats (string)
  Vehicles with variable number of seats return range of number of seats. Vehicles with static number of seats return still one number.
  
  Example:
```
5-7
```
New parameters added:
- VIN (string)
  Requested VIN is now returned as a part of response
  
  Example:
```
XXXDEF1GH23456789
```
- Vehicle Specification (string)
  Full vehicle specification
  
  Example:
```
ŠKODA OCTAVIA COMBI SEAHFX95A8DAD5 1.9 D
```
- Wheel Size Array (array)
  Standalone array field for Wheel Size to list multiple options and guarantee backward compatibility
  
  Example:
```
[
  0 => "255/40 R19 96 Y",
  1 => "275/40 R19 101 Y"
]
```
- Wheel Rims Size Array (array)
  Standalone array field for Wheel Rims Size to list multiple options and guarantee backward compatibility
  
  Example:
```
[
  0 => "9JX19CH ET45.0",
  1 => "9.5JX19CH ET52.5"
]
```
- Wheelbase (mm) Array (array)
  Standalone array field for Wheelbase to list multiple options and guarantee backward compatibility
  
  Example:
```
[
  0 => 1582,
  1 => 1640
]
```
Deprecated API Endpoint:
- Leasing Check

2023-02-01

Deprecated all v3.0 endpoints

2019-07-06

Model Year improvements

2019-04-29 Released API 3.0

Control sum calculation synchronized across all endpoints.

Data type changes

Odometer (km) (int) → Odometer (km) (array)
Array of odometer development in time.

Example:

[
0 => [
  "date" => "2016-08-03",
  "odometer" => 235000
],
  1 => [
    "date" => "2017-02-28",
    "odometer" => 244000
  ]
]

New parameters added:

Price (array)
Array of price development in time.

Example:

[
  0 => [
    "date"     => "2016-07-31",
    "price"    => 289900,
    "currency" => "CZK",
  ],
  1 => [
    "date"     => "2016-09-20",
    "price"    => 274900,
    "currency" => "CZK",
  ],
]

VIN Legal Check endpoint separated into two standalone endpoints:
- API Stolen Check
- API Leasing Check

2021-07-01

Deprecated all v2.0 endpoints

2020-11-12

Deprecated VIN Legal Check endpoint

2016-04-02 Released API 2.0

2013-02-16 Released API 1.0