# eu-verify VIN Decoder

> eu-verify VIN Decoder is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Decodes a Vehicle Identification Number (VIN) to return full vehicle details including make, model, year, engine, body class, and manufacturer using NHTSA vPIC data.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/vehicle/vin
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-verify-vin-decoder-a2b2bf05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4JUR7q9PhxhfIswK4pSRd

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 eu-verify-vin-decoder-a2b2bf05
```

Example prompt: Can you decode the VIN 1HGCM82633A004352 and tell me the make, model, year, engine specs, and body style of that vehicle?

## When to prefer this

Use this endpoint when you need to decode a North American VIN and retrieve structured vehicle specification data from the official NHTSA vPIC database. It is ideal for automotive compliance checks, vehicle verification workflows, used-car valuation pipelines, and any scenario requiring authoritative make/model/year/engine data from a government source. It supports partial VIN lookups with wildcards, making it useful for fleet or recall screening.

## Known failure modes

- Invalid or malformed VIN returns a non-zero error_code with an error_text describing the issue
- VIN shorter than 17 chars requires wildcard '*' usage or model_year hint for partial decoding
- Unknown or non-US VIN may return partial data with null fields
- HTTP 402 returned if payment not attached — must pay 0.005 USDC via x402 on Base before retrying
- VIN not found in NHTSA database returns empty or null fields for most attributes

## How this service works

Decodes a Vehicle Identification Number through the official US regulator's vPIC database (public domain): make, model, year, body class, engine, transmission, GVWR and assembly plant. Query: ?vin=1HGCM82633A004352 (partial VINs with '*' accepted, optional &model_year=2003). error_code/error_text carry vPIC's structural verdict. Static reference data, 24h cache.

## Output

A JSON object containing decoded vehicle attributes including make, model, model year, trim, body class, doors, engine horsepower, fuel type, drive type, transmission type, vehicle type, displacement in liters, cylinder count, GVWR class, manufacturing plant location (city, state, country), manufacturer name, and a decode error code/text indicating whether the VIN is valid.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "vin"
     ],
     "properties": {
      "vin": {
       "type": "string",
       "description": "VIN, 5-17 chars; '*' wildcard allowed for partial VINs"
      },
      "model_year": {
       "type": "string",
       "description": "Model year hint to improve decoding (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vin": "1HGCM82633A004352",
  "gvwr": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
  "make": "HONDA",
  "trim": "EX-V6",
  "doors": "2",
  "model": "Accord",
  "plant": {
   "city": "MARYSVILLE",
   "state": "OHIO",
   "country": "UNITED STATES (USA)"
  },
  "series": null,
  "source": "NHTSA vPIC (US DOT), public domain",
  "engine_hp": "240",
  "fuel_type": "Gasoline",
  "body_class": "Coupe",
  "drive_type": null,
  "error_code": "0",
  "error_text": "0 - VIN decoded clean. Check Digit (9th position) is correct",
  "model_year": "2003",
  "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
  "transmission": "Automatic",
  "vehicle_type": "PASSENGER CAR",
  "displacement_l": "2.998832712",
  "engine_cylinders": "6"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-verify-vin-decoder-a2b2bf05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)