Skip to content

opencars/vin-decoder-api

Repository files navigation

VIN Decoder

🚗 Decoding vehicle identification number

Development

Build the binary

make

Start postgres

docker-compose up -Vd

Run sql migrations

migrate -source file://migrations -database postgres://postgres:password@127.0.0.1:5432/vin-decoder\?sslmode=disable up

Run the web server

./bin/server

Usage

For example, you get information about this amazing Tesla Model X

http http://localhost:8080/api/v1/vin-decoder/5YJXCCE40GF010543
{
  "vehicle": {
    "check_digit": true,
    "country": "United States",
    "manufacturer": "Tesla, Inc.",
    "region": "North America",
    "serial": "010543",
    "year": 2016
  },
  "vin": {
    "vds": "XCCE40",
    "vis": "GF010543",
    "wmi": "5YJ"
  }
}

License

Project released under the terms of the MIT license.