| Name | vin JSON |
| Version |
0.6.2
JSON |
| download |
| home_page | None |
| Summary | Vehicle Identification Number |
| upload_time | 2024-03-25 02:10:28 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
nhtsa
vehicle
vin
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# VIN
[](https://pypi.org/project/vin)
[](https://pypi.org/project/vin)
[](https://github.com/davidpeckham/vin/blob/main/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](https://www.ecfr.gov/current/title-49/subtitle-B/chapter-V/part-565).
## Vehicle Data
Vehicle data is provided by the U.S. National Highway Traffic Safety Administration (NHTSA) [Product Information Catalog and Vehicle Listing (vPIC)](https://vpic.nhtsa.dot.gov).
## License
``VIN`` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
Raw data
{
"_id": null,
"home_page": null,
"name": "vin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "nhtsa, vehicle, vin",
"author": null,
"author_email": "David Peckham <dave.peckham@icloud.com>",
"download_url": "https://files.pythonhosted.org/packages/0d/31/c962fb3c6b4e952ae6b47eae439ef6bba36ecae0b5b3a25be22d33cc9538/vin-0.6.2.tar.gz",
"platform": null,
"description": "# VIN\n\n[](https://pypi.org/project/vin)\n[](https://pypi.org/project/vin)\n[](https://github.com/davidpeckham/vin/blob/main/LICENSE)\n\n\n-----\n\n``VIN`` validates Vehicle Identification Numbers and decodes the vehicle's manufacturer, make, model, series, trim, and model year.\n\n >>> from vin import VIN\n\n >>> VIN('KNDCE3LG2L5073161').description\n '2020 Kia Niro EX Premium'\n\n >>> vin(\"5FNYF5H59HB011946\").manufacturer\n 'Honda'\n\n >>> vin(\"5FNYF5H59HB011946\").model_year\n 2017\n\n >>> vin(\"YT9NN1U14KA007175\").manufacturer\n 'Koenigsegg'\n\n``VIN`` supports passenger vehicles manufactured since 1980:\n\n* Passenger Cars\n* Multipurpose Passenger Vehicle (MPV)\n* Light Trucks\n\n``VIN`` does not currently support:\n\n* Buses\n* Heavy Trucks\n* Incomplete Vehicles\n* Low Speed Vehicles (LSV)\n* Motorcycles\n* Off Road Vehicles\n* Trailers\n\n## Why use VIN?\n\n- **Accurate** — Uses U.S. National Highway Traffic Safety Administration vehicle data.\n- **Fast** — Validate and decode hundreds of VINs per second.\n\n## Installation\n\nUse ``pip`` to install the library:\n\n $ pip install vin\n\n## Vehicle Identification Number\n\nA ```VIN``` is a unique 17-character Vehicle Identification Number.\n\n* Uniquely identifies vehicles manufactured for sale or use in the United States since 1980\n* Assigned by vehicle manufacturers\n* Governed by the U.S. National Highway Traffic Safety Administration (NHTSA)\n\nThe structure of the VIN is:\n\n model year\n |\n WMI check digit | plant\n |-----| | | | |--- serial ----|\n Position 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17\n |-----------| |---------------------|\n VDS VIS\n\nThe World Manufacturer Identifier (WMI) holds the country, region, and\nname of the vehicle manufacturer. Mass-market manufacturers are assigned\na three-character WMI. Specialized manufacturers are assigned a six-\ncharacter WMI (positions 1-3 and 12-14)\n\nThe Vehicle Description Section (VDS) is defined by manufacturers to\nidentify the vehicle make, model, body type, engine type, restraints,\nand the weight class (for trucks and multi-purpose vehicles).\n\nThe Vehicle Identification Section (VIS) identifies the model year,\nplant where the vehicle was made, and the vehicle's serial number.\n\nFor more information, see the [VIN specification](https://www.ecfr.gov/current/title-49/subtitle-B/chapter-V/part-565).\n\n## Vehicle Data\n\nVehicle data is provided by the U.S. National Highway Traffic Safety Administration (NHTSA) [Product Information Catalog and Vehicle Listing (vPIC)](https://vpic.nhtsa.dot.gov).\n\n## License\n\n``VIN`` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.",
"bugtrack_url": null,
"license": null,
"summary": "Vehicle Identification Number",
"version": "0.6.2",
"project_urls": {
"Documentation": "https://vin.readthedocs.io/en/latest/index.html",
"Issues": "https://github.com/davidpeckham/vin/issues",
"Source": "https://github.com/davidpeckham/vin"
},
"split_keywords": [
"nhtsa",
" vehicle",
" vin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "549bc7b60fc68c10d953cde4da8660fb7e09e3b8294600d2a965836ed87aa51e",
"md5": "78bd122f1b7beb2ce8443fae60481893",
"sha256": "d854492e7278b52546c5de5002bd6e66c57ff810b3dc87404d0e1df5e0846f36"
},
"downloads": -1,
"filename": "vin-0.6.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "78bd122f1b7beb2ce8443fae60481893",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 13747160,
"upload_time": "2024-03-25T02:10:25",
"upload_time_iso_8601": "2024-03-25T02:10:25.237103Z",
"url": "https://files.pythonhosted.org/packages/54/9b/c7b60fc68c10d953cde4da8660fb7e09e3b8294600d2a965836ed87aa51e/vin-0.6.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0d31c962fb3c6b4e952ae6b47eae439ef6bba36ecae0b5b3a25be22d33cc9538",
"md5": "5377e394a6bf31b2631f54d2abe1dbe9",
"sha256": "4caa659d5b40a664dd3b2bcc6c6dbd3e203e6ac5b237d914dac08550428b86d3"
},
"downloads": -1,
"filename": "vin-0.6.2.tar.gz",
"has_sig": false,
"md5_digest": "5377e394a6bf31b2631f54d2abe1dbe9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 13705693,
"upload_time": "2024-03-25T02:10:28",
"upload_time_iso_8601": "2024-03-25T02:10:28.158639Z",
"url": "https://files.pythonhosted.org/packages/0d/31/c962fb3c6b4e952ae6b47eae439ef6bba36ecae0b5b3a25be22d33cc9538/vin-0.6.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-25 02:10:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "davidpeckham",
"github_project": "vin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "vin"
}
