# Vehicle VIN Toolkit – VIN Structure Parser

> Vehicle VIN Toolkit – VIN Structure Parser is a paid API for AI agents from vehicle-vin.x402tookit.com, paid per call via x402, $0.02/call, status down (last checked 2026-10-23).

Splits a 17-character VIN into its structural components (WMI, VDS, VIS) and returns region, country, model-year candidates, plant code, and serial number.

## Facts

- Endpoint: GET https://vehicle-vin.x402tookit.com/vin-structure?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vehicle-vin-toolkit-vin-structure-parser-36295a05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R9Rb3419gjLvegIZOjc7S

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 vehicle-vin-toolkit-vin-structure-parser-36295a05
```

Example prompt: Can you split the VIN 1M8GDM9AXKP042788 into its WMI, VDS, and VIS parts and tell me the region, country, plant code, and possible model years encoded in it?

## When to prefer this

Choose this endpoint when you need the raw structural decomposition of a VIN — its WMI, VDS, and VIS segments plus region, country, plant code, serial number, and model-year candidates — without performing a full NHTSA vPIC decode. It is faster and cheaper than the full decode endpoint and ideal when you only need the anatomical breakdown rather than make, model, trim, engine, or body style details. Prefer this over the validation-only endpoint when you need more than a pass/fail result, but don't yet need the full NHTSA lookup.

## Known failure modes

- VIN shorter or longer than 17 characters returns a validation error
- VIN containing disallowed characters (I, O, Q) triggers an error
- Ambiguous or unrecognized WMI may return null region/country fields
- Small manufacturers with 9-digit serial scheme may set smallManufacturer flag and alter segment boundaries
- Service degraded mode returns partial results with degraded=true and notChecked list
- Invalid or missing vin query parameter returns a 400-level error

## How this service works

Split a VIN into manufacturer code, descriptor and serial parts with region, country and model-year candidates.

## Output

Returns a structured breakdown of the VIN including: the 3-character WMI (manufacturer prefix), the 6-character VDS (vehicle descriptor), the 8-character VIS (vehicle identifier), normalised VIN string, region and country of manufacture, model year code character, a list of likely model year candidates, the most likely model year and its basis, plant code, serial number, check digit position, a summary verdict, and any degraded-mode flags or disclaimer notes.

## 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": [
      "vin"
     ],
     "properties": {
      "vin": {
       "type": "string",
       "description": "The 17-character VIN, e.g. 1M8GDM9AXKP042788"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "vds": {
       "type": [
        "null",
        "string"
       ]
      },
      "vis": {
       "type": [
        "null",
        "string"
       ]
      },
      "wmi": {
       "type": [
        "null",
        "string"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "region": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "country": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "plantCode": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "normalised": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "serialNumber": {
       "type": [
        "null",
        "string"
       ]
      },
      "modelYearCode": {
       "type": [
        "null",
        "string"
       ]
      },
      "likelyModelYear": {
       "type": [
        "null",
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vehicle-vin-toolkit-vin-structure-parser-36295a05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vehicle-vin.x402tookit.com](https://www.zero.xyz/host/vehicle-vin.x402tookit.com/llms.txt)