agentutility(7)$ man vin-decode
/vin-decode
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
localeCATEGORY
uncategorized
STATUS
● live
NAME
vin-decode — decodes a 17-character vin into full vehicle details, backed by nhtsa's vpic data (us govt public domain)
SYNOPSIS
POST https://x402.agentutility.ai/vin-decode
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Decodes a 17-character VIN into full vehicle details, backed by NHTSA's vPIC data (US Govt public domain). Returns make, model, model_year, manufacturer, plant country, body class, vehicle type, fuel type, engine cylinders/displacement/HP, drive type, transmission, GVWR, safety features (ABS, traction control, airbags), and any decode errors. Includes a `valid_checksum` flag (ISO 3779 mod-11 check; reliable for North-American VINs). Use it as a VIN decoder, VIN lookup, vehicle identification number resolver, or NHTSA vPIC wrapper.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| vin | string | 17-character VIN. Alphanumeric, no I/O/Q (those are excluded from the VIN alphabet to avoid confusion with 1/0). | required |
| model_year | integer | string | Optional model year hint (YYYY). Helps NHTSA disambiguate the 10th position when the same WMI was reused across model years. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| vin | string | Echoed 17-character VIN that was decoded, uppercased and stripped of whitespace. |
| valid_checksum | boolean | True if the VIN passes the ISO 3779 mod-11 check digit; reliable for North-American VINs. |
| decode_ok | boolean | True if NHTSA vPIC returned a usable decode with no fatal errors. |
| errors | array | List of decode error codes/messages reported by vPIC (e.g. invalid characters, unknown WMI). |
| make | stringnull | Vehicle make (e.g. Ford, Toyota), or null if vPIC could not determine it. |
| model | stringnull | Vehicle model name (e.g. F-150, Camry), or null if not resolvable from the VIN. |
| model_year | integernull | Four-digit model year decoded from the VIN, or null if vPIC could not determine it. |
| manufacturer | stringnull | Full manufacturer name as registered with NHTSA (e.g. Ford Motor Company), or null. |
| body_class | stringnull | Body style classification (e.g. Sedan/4-Door, Pickup, SUV), or null if unavailable. |
| vehicle_type | stringnull | Top-level vehicle type (e.g. Passenger Car, Truck, Motorcycle), or null. |
| fuel_type_primary | stringnull | Primary fuel type (e.g. Gasoline, Diesel, Electric), or null if not reported. |
| source | string | Upstream data source identifier, always "NHTSA vPIC" for this endpoint. |
| attribution | string | Required attribution string crediting NHTSA's vPIC public-domain dataset. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/vin-decode \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the vin-decode tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- vinvehiclecarautomotivenhtsadecode
- methods
- POST
- cluster
- locale
- price
- $0.005 USDC per call
ADJACENT — other endpoints in locale
| endpoint | description | price |
|---|---|---|
| air-quality | Returns current air quality readings and AQI category for any latitude/longitude, with optional hourly forecast rows for the next 1-72 hours. | $0.005 |
| airport-code-lookup | Resolves airport codes to airport name, municipality, country, region, coordinates, elevation, scheduled-service flag, homepage, and Wiki… | $0.005 |
| astro-times | Sunrise sunset times. | $0.005 |
| climate-data | Returns historical daily temperature, precipitation, humidity, wind, and solar radiation for any latitude/longitude. | $0.005 |
| country-info | Country info lookup. | $0.005 |
| current-weather | Looks up current weather conditions for a latitude/longitude: temperature, humidity, precipitation, wind, and WMO condition code. | $0.005 |
| holiday-lookup | Holiday calendar. | $0.005 |
| iata-airport-info | Looks up airport metadata from an IATA or ICAO code. | $0.005 |
SEE ALSO