# ForgeMesh VIN Decoder

> ForgeMesh VIN Decoder is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Decodes any 17-character VIN (or partial VIN) into structured vehicle specs including make, model, year, trim, engine, transmission, and more.

## Facts

- Endpoint: POST https://x402.forgemesh.io/vin-decode
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-vin-decoder-0c682eb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8JoOUSxVAHDj8UhQfahzy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-vin-decoder-0c682eb9 -d '<json body>'
```

Example prompt: Decode VIN 1HGCM82633A123456 and give me the full vehicle specs — make, model, year, trim, engine, transmission, and drive type.

## When to prefer this

Use this endpoint when you need official-grade structured vehicle specifications from a VIN, especially in automotive, insurance, dealer, or marketplace contexts. It supports partial VIN decoding with wildcards, making it useful even when the full VIN is unavailable. Prefer it over general-purpose lookup tools when you need specific mechanical specs like engine displacement, horsepower, transmission, and GVWR rather than just make/model/year.

## Known failure modes

- Invalid VIN format (not 17 chars and no wildcards, or fewer than 6 chars) returns an error
- VIN check digit validation failure for structurally invalid VINs
- Unknown or unrecognized VIN pattern returns empty or null spec fields
- Partial VIN with too many wildcards may return ambiguous or multiple possible results
- Payment failure (insufficient USDC balance) blocks the request

## How this service works

VIN decoder API: turn any 17-character vehicle identification number into structured specs — make, model, year, trim, body class, engine (cylinders, displacement, horsepower, fuel), transmission, drive type, doors, GVWR, and assembly plant. Handles partial VINs with * wildcards. Official registration-grade decode for automotive, insurance, dealer, and marketplace agents. Response includes affiliate offers for full VIN history reports.

## Output

Returns structured vehicle data fields parsed from the VIN: make, model, model year, trim, body class, engine specifications (cylinders, displacement, horsepower, fuel type), transmission type, drive type, number of doors, gross vehicle weight rating (GVWR), and assembly plant location. Supports partial VINs with * wildcards for unknown characters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vin": {
   "type": "string",
   "description": "the VIN — full 17 chars or partial with * wildcards (min 6 chars)"
  },
  "model_year": {
   "type": "string",
   "description": "optional 4-digit model year hint, improves partial-VIN decodes"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-vin-decoder-0c682eb9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)