Vehicle Identification Number
Project description
VIN
VIN
validates Vehicle Identification Numbers and decodes the vehicle's manufacturer, make, model, series, trim, and model year.
>>> from vin import VIN
>>> VIN('KNDCE3LG2L5073161').description
'2020 Kia Niro EX Premium'
>>> vin("5FNYF5H59HB011946").manufacturer
'Honda'
>>> vin("5FNYF5H59HB011946").model_year
2017
>>> vin("YT9NN1U14KA007175").manufacturer
'Koenigsegg'
VIN
supports passenger vehicles manufactured since 1980:
- Passenger Cars
- Multipurpose Passenger Vehicle (MPV)
- Light Trucks
VIN
does not currently support:
- Buses
- Heavy Trucks
- Incomplete Vehicles
- Low Speed Vehicles (LSV)
- Motorcycles
- Off Road Vehicles
- Trailers
Why use VIN?
- Accurate — Uses U.S. National Highway Traffic Safety Administration vehicle data.
- Fast — Validate and decode hundreds of VINs per second.
Installation
Use pip
to install the library:
$ pip install vin
Vehicle Identification Number
A VIN
is a unique 17-character Vehicle Identification Number.
- Uniquely identifies vehicles manufactured for sale or use in the United States since 1980
- Assigned by vehicle manufacturers
- Governed by the U.S. National Highway Traffic Safety Administration (NHTSA)
The structure of the VIN is:
model year
|
WMI check digit | plant
|-----| | | | |--- serial ----|
Position 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
|-----------| |---------------------|
VDS VIS
The World Manufacturer Identifier (WMI) holds the country, region, and name of the vehicle manufacturer. Mass-market manufacturers are assigned a three-character WMI. Specialized manufacturers are assigned a six- character WMI (positions 1-3 and 12-14)
The Vehicle Description Section (VDS) is defined by manufacturers to identify the vehicle make, model, body type, engine type, restraints, and the weight class (for trucks and multi-purpose vehicles).
The Vehicle Identification Section (VIS) identifies the model year, plant where the vehicle was made, and the vehicle's serial number.
For more information, see the VIN specification.
Vehicle Data
Vehicle data is provided by the U.S. National Highway Traffic Safety Administration (NHTSA) Product Information Catalog and Vehicle Listing (vPIC).
License
VIN
is distributed under the terms of the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file vin-0.6.2.tar.gz
.
File metadata
- Download URL: vin-0.6.2.tar.gz
- Upload date:
- Size: 13.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4caa659d5b40a664dd3b2bcc6c6dbd3e203e6ac5b237d914dac08550428b86d3 |
|
MD5 | 5377e394a6bf31b2631f54d2abe1dbe9 |
|
BLAKE2b-256 | 0d31c962fb3c6b4e952ae6b47eae439ef6bba36ecae0b5b3a25be22d33cc9538 |
File details
Details for the file vin-0.6.2-py3-none-any.whl
.
File metadata
- Download URL: vin-0.6.2-py3-none-any.whl
- Upload date:
- Size: 13.7 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d854492e7278b52546c5de5002bd6e66c57ff810b3dc87404d0e1df5e0846f36 |
|
MD5 | 78bd122f1b7beb2ce8443fae60481893 |
|
BLAKE2b-256 | 549bc7b60fc68c10d953cde4da8660fb7e09e3b8294600d2a965836ed87aa51e |