vindec
v2.8.0
Published
VIN Decoder
Downloads
221
Readme
vindec
Node.js VIN decoding package
Installation
If you prefer the previous version of this module, please use npm install [email protected]
. The current version creates a constructor, but the functionality is the same.
Usage
const vindec = require('vindec');
console.log(`Valid: ${vindec.validate('YOURMOM')}`) // false
console.log(JSON.stringify(vindec.decode('meh'))) // { vin: 'meh', valid: false }
You may optionally add a callback as a second argument to decode for error checking as in the past, but it has been simplified and will always return an object.
Information Decoded
{ vin: '12345678901234567',
valid: true,
wmi: '123',
vds: '5678',
checkDigit: '9',
vis: '01234567',
region: 'Somewhere Around Here',
make: 'UFO',
year: '1776',
sequence_id: '234567' }
NHTSA API Calls
Fetches the vehicle information from the NHTSA api. As a bonus, there is an opportunity to utilize the error responses from their api to provide better error handling to vindec in the future.
NHTSA API Documentation
You may read the official NHTSA API documentaiton site. Additionally, if you're feeling squirrelly and want to hit other endpoints, feel free to modify ./lib/nhtsa.js
to your liking, I may add/change somethings here in the future, be forewarned.
Usage (test)
const vin = '1G1BC53X76F123456' // example
const vindec = new Vindec()
vindec.nhtsa(vin).then(res => {
console.log(res.data)
}).catch(err => {
console.error(err)
})