# Vehicle VIN Toolkit

Decode and validate VINs, look up manufacturers, makes and models from NHTSA vPIC, plus pure VIN structure tools.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://vehicle-vin.x402tookit.com/openapi.json
- x402 manifest: https://vehicle-vin.x402tookit.com/.well-known/x402
- Catalog (free): https://vehicle-vin.x402tookit.com/catalog
- Health (free): https://vehicle-vin.x402tookit.com/health
- Uptime (free): https://vehicle-vin.x402tookit.com/uptime

## Endpoints (9)

### GET /makes-by-type — $0.02
List the vehicle makes NHTSA records for a vehicle type (car, truck, motorcycle, bus, trailer), with an optional name filter.
Params: type: string, contains?: string, limit?: integer
Example: https://vehicle-vin.x402tookit.com/makes-by-type?type=car&contains=ford

### GET /manufacturer-wmis — $0.02
List the VIN manufacturer prefixes (WMIs) registered for a manufacturer name such as Honda, with country and vehicle type.
Params: name: string, limit?: integer
Example: https://vehicle-vin.x402tookit.com/manufacturer-wmis?name=Tesla

### GET /model-year-code — $0.02
Convert a model year (1980-2039) to its VIN position-10 code, or a code to its two possible years.
Params: year?: integer, code?: string
Example: https://vehicle-vin.x402tookit.com/model-year-code?year=2019

### GET /models-by-make-year — $0.02
List the vehicle models NHTSA records for a make in a given model year, optionally filtered by vehicle type.
Params: make: string, year: integer, type?: string, contains?: string, limit?: integer
Example: https://vehicle-vin.x402tookit.com/models-by-make-year?make=Honda&year=2015

### GET /vehicle-types-for-make — $0.02
List the vehicle types (car, truck, motorcycle, MPV) NHTSA records for a make, separating exact make matches from look-alikes.
Params: make: string
Example: https://vehicle-vin.x402tookit.com/vehicle-types-for-make?make=Honda

### GET /vin-decode — $0.02
Decode a VIN with NHTSA vPIC: make, model, year, trim, body, engine, plant and decoder warnings, with a check-digit cross-check.
Params: vin: string, year?: integer
Example: https://vehicle-vin.x402tookit.com/vin-decode?vin=1HGCM82633A004352

### GET /vin-structure — $0.02
Split a VIN into manufacturer code, descriptor and serial parts with region, country and model-year candidates.
Params: vin: string
Example: https://vehicle-vin.x402tookit.com/vin-structure?vin=1M8GDM9AXKP042788

### GET /vin-validate — $0.02
Validate a VIN: 17 characters, no I/O/Q, and the position-9 check digit per 49 CFR 565, with the expected digit.
Params: vin: string
Example: https://vehicle-vin.x402tookit.com/vin-validate?vin=1M8GDM9AXKP042788

### GET /wmi-lookup — $0.02
Look up the manufacturer, make and vehicle type behind a 3-character VIN prefix (WMI), with region and country.
Params: wmi: string
Example: https://vehicle-vin.x402tookit.com/wmi-lookup?wmi=1HG

## Terms

Vehicle facts come from the NHTSA vPIC database (self-reported by manufacturers under US rules) and local computation per 49 CFR 565, provided as is. Coverage is mainly vehicles built for the US market, blank fields mean NHTSA has no data, not that a feature is absent, and a decode is not a history, title, recall, theft or ownership check. Not legal or purchase advice.