# Mekler AI VIN Decoder

> Mekler AI VIN Decoder is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Decodes a 17-character VIN against NHTSA vPIC, returning manufacturer, model-year, and equipment fields along with source errors, missing fields, and check-digit validation.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/data/vehicles/check-vin?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-vin-decoder-3eaf00b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RXf8tu82pt27cnw1QaTWV

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 mekler-ai-vin-decoder-3eaf00b3 -d '<json body>'
```

Example prompt: Can you decode the VIN 5UXWX7C5XBA123456 for me? It's a 2011 model year — I want to know the make, model, body class, and whether the check digit is valid.

## When to prefer this

Choose this endpoint when you need structured NHTSA manufacturer and equipment fields decoded from a raw 17-character VIN, particularly for US-market vehicles, and when you also need explicit check-digit validation and source error transparency. Prefer it over generic VIN lookup tools when you need source-linked, NHTSA-authoritative data with clear limitations stated (not ownership, accident history, or valid-vehicle certification). It is ideal for pre-purchase due diligence, fleet intake enrichment, or compliance workflows where auditability of the decode source matters.

## Known failure modes

- Invalid VIN format (not matching ^[A-HJ-NPR-Z0-9]{17}$) — rejected before upstream call
- NHTSA returns non-zero source error codes indicating unrecognized WMI or partial decode — returned as completed diagnostic with errors listed
- Check digit mismatch — returned as evidence in check_digit object, not a blocking error
- Model year outside 1981–2100 range — input validation failure
- Non-US-market vehicle with limited NHTSA coverage — partial decode with limitations noted
- Network or upstream NHTSA API timeout — service error response

## How this service works

Decode a complete 17-character VIN into source-linked NHTSA manufacturer, model-year and equipment fields. Return source errors, missing fields and independent check-digit evidence. Optional model year helps disambiguate the source. Coverage centers on US-market vehicles; no owner, title, accident-history, condition or valid-vehicle certification.

## Output

Returns a JSON object with the decoded VIN specifications (make, model, model year, trim, series, body class, drive type, fuel type, engine size, cylinders, plant country, vehicle type, manufacturer), a check-digit validation result showing expected vs. observed digit, source error codes, a decode_complete flag, the NHTSA source URL used, an observed_at timestamp, and a limitations array explaining coverage gaps and non-certification caveats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vin": {
   "type": "string",
   "pattern": "^[A-HJ-NPR-Z0-9]{17}$"
  },
  "model_year": {
   "type": "integer",
   "maximum": 2100,
   "minimum": 1981
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{16,64}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vin": "5UXWX7C5XBA123456",
  "source": "NHTSA vPIC",
  "status": "ok",
  "source_url": "https://vpic.nhtsa.dot.gov/api/vehicles/DecodeVinValues/5UXWX7C5XBA123456?format=json&modelyear=2011",
  "check_digit": {
   "matches": false,
   "expected": "7",
   "observed": "X",
   "north_american_rule_applicable": true
  },
  "limitations": [
   "Manufacturer-submitted specifications for vehicles intended for the US market; other markets can have limited coverage.",
   "A decoded field is not evidence of ownership, title, accident history, condition or installed equipment today.",
   "Inspect source errors and check-digit evidence. A partial or invalid source decode is a completed diagnostic, not a valid-vehicle certification."
  ],
  "observed_at": "2026-10-20T00:00:00Z",
  "source_message": "Synthetic fixture only",
  "specifications": {
   "make": "SYNTHETIC",
   "trim": null,
   "model": "Example",
   "series": null,
   "fuel_type": null,
   "body_class": null,
   "drive_type": null,
   "model_year": "2011",
   "manufacturer": null,
   "vehicle_type": null,
   "engine_liters": null,
   "plant_country": null,
   "engine_cylinders": null
  },
  "decode_complete": true,
  "source_error_codes": [
   "0"
  ],
  "requested_model_year": 2011
 }
}
```

## More

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