VIN validate & decode API

Validates the ISO 3779 VIN mod-11 check digit and decodes WMI/VDS/VIS, world region, model-year candidates, and serial. Answers 'Is this VIN valid?', 'What does this VIN decode to?'.

Price$0.04per request

MethodPOST

Route/v1/validate/vin

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

vinvehiclecheck-digitmod-11iso-3779wmivalidateautomotivedecode

API URLhttps://x402.hexl.dev/v1/validate/vin

Integration docs

Example request

{
  "vin": "1HGCM82633A004352"
}

Example response

{
  "valid": true,
  "reason": "VIN check digit valid; WMI/VDS/VIS parsed.",
  "normalized": "1HGCM82633A004352",
  "checkDigit": {
    "expected": "3",
    "actual": "3"
  },
  "wmi": "1HG",
  "vds": "CM8263",
  "vis": "3A004352",
  "region": "North America",
  "modelYearCandidates": [
    2003,
    2033
  ],
  "serial": "004352"
}

Input schema

{
  "type": "object",
  "required": [
    "vin"
  ],
  "properties": {
    "vin": {
      "type": "string",
      "description": "17-character Vehicle Identification Number.",
      "examples": [
        "1HGCM82633A004352"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}