Skip to main content

Vehicle Identification Number

Project description

VIN

PyPI - Version PyPI - Python Version license


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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vin-0.6.2.tar.gz (13.7 MB view details)

Uploaded Source

Built Distribution

vin-0.6.2-py3-none-any.whl (13.7 MB view details)

Uploaded Python 3

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

Hashes for vin-0.6.2.tar.gz
Algorithm Hash digest
SHA256 4caa659d5b40a664dd3b2bcc6c6dbd3e203e6ac5b237d914dac08550428b86d3
MD5 5377e394a6bf31b2631f54d2abe1dbe9
BLAKE2b-256 0d31c962fb3c6b4e952ae6b47eae439ef6bba36ecae0b5b3a25be22d33cc9538

See more details on using hashes here.

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

Hashes for vin-0.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d854492e7278b52546c5de5002bd6e66c57ff810b3dc87404d0e1df5e0846f36
MD5 78bd122f1b7beb2ce8443fae60481893
BLAKE2b-256 549bc7b60fc68c10d953cde4da8660fb7e09e3b8294600d2a965836ed87aa51e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page