frankely / vin-decoder

VIN Decoder

Vehicle Identification Number Decoder

VIN Decoder

API

Validate VIN

const isValid = validate('1NXBR32E77Z923602') // true

Validate VIN with special checksum as parameter

const isValid = validate('1HVLNHGN9FHA63345', 8) // true

Split Identification Number

Year Code

const year = split('1NXBR32E77Z923602').year // 7

Security Code

const securityCode = split('1NXBR32E77Z923602').securityCode // 7

Assembly Plant

const assemblyPlant = split('1NXBR32E77Z923602').assemblyPlant // Z

Made In

const madeIn = split('1NXBR32E77Z923602').madeIn // 1N

Manufacturer

const manufacturer = split('1NXBR32E77Z923602').manufacturer // 1NX

Details

const details = split('1NXBR32E77Z923602').details // BR32E

Serial Number

const serialNumber = split('1NXBR32E77Z923602').serialNumber //923602

Decode Identification Number

Country

const country = decode('1NXBR32E77Z923602').country // United States

Serial Number

const serialNumber = decode('1NXBR32E77Z923602').serialNumber // 923602

Manufacturer

const serialNumber = decode('1NXBR32E77Z923602').manufacturer // NUMMI USA

vin-decoder's Issues

Add more descriptive data

When splitting a VIN we are returning only the codes without descriptions or details so they are better to present or understand for

• Year
• Assembly Plant
• Manufacturer
• Made In

Let's add another layer of information for those codes where we also expose the description.

How to get the Model of a Vehicle

This is not an issue, just a question,
How do I obtain the model of a car using this module (and perhaps a suggested supplementary lookup table) ?

Release version 1.2.0

Includes:

• Validate VIN with special checksum as parameter. Thanks to @darwin2k

Add contributors file

Improve validity function

It seems that you need to improve the validity function. Just checking the length isn’t enough. Here are other criteria:

• Cannot have any of I, O, or Q in the VIN
• last five digits have to be numbers
• Check digit needs to be correct

I have a 150-line function that checks for all of this, remind me soon to make a PR.

test cases fail

Is this validator restricted to VINs from specific countries?

Some test cases breaks for me. The validate function returns false but the VIN seems to be correct.

you can create random VINs here:
https://vingenerator.org/
https://randomvin.com/

https://www.vindecoderz.com/
delivers results for the failing VINs

here are some VIN examples:
WBANF73576CG65408
1D7HA16D94J171206
1G1RC6E41BU103560

npmjs module is not working

When I try to test the npmjs module I get this error:
Error: ENOENT, no such file or directory 'data/countries.json'

https://tonicdev.com/5693d7df33b2840c007fd5c8/5693d7df33b2840c007fd5c9