# agentshield.live VIN Decoder

> agentshield.live VIN Decoder is a paid API for AI agents from agentshield.live, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-19).

Decodes a 17-character VIN to extract the world manufacturer identifier (WMI), region, check digit validity, and known-manufacturer status.

## Facts

- Endpoint: GET https://agentshield.live/vin?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshield-live-vin-decoder-b534b1ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HfDpvN74izZJKj1Q49LwD

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 agentshield-live-vin-decoder-b534b1ae
```

Example prompt: Can you decode this VIN for me — 1HGCM82633A004352 — and tell me the world manufacturer identifier, the region, and whether the check digit is valid?

## When to prefer this

Use this endpoint when you have a raw VIN string and need to quickly extract the WMI, region, and check digit validity without looking up any vehicle registry or database. It is ideal for data validation pipelines, import workflows, or any scenario where you need structural VIN parsing rather than full vehicle history. Prefer this over heavyweight vehicle history APIs when you only need standards-based structural decoding at minimal cost ($0.005 per call).

## Known failure modes

- VIN not exactly 17 characters returns an error or 404
- Invalid characters in VIN (e.g. I, O, Q) cause validation failure
- Unknown WMI still returns a response but 'known' will be false
- Network or service unavailability returns a non-200 HTTP status
- Missing 'code' query parameter causes a bad request error

## How this service works

Call when an agent has a VIN and needs the check digit, the world manufacturer identifier, and the region. Does not confirm a specific vehicle.

## Output

Returns a JSON object with: 'wmi' (the 3-character World Manufacturer Identifier string), 'region' (e.g. 'US', 'EU', 'JP'), 'valid' (boolean indicating check digit validity), and 'known' (boolean indicating whether the WMI is a recognized manufacturer). Does not return vehicle-specific details like make, model, or year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "code"
     ],
     "properties": {
      "code": {
       "type": "string",
       "description": "17-character VIN."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "wmi": "1HG",
  "known": true,
  "valid": true,
  "region": "US"
 }
}
```

## More

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