# 2s VIN Decode

> 2s VIN Decode is a paid API for AI agents from 2s.io, paid per call via x402, $0.0024/call, status unknown (last checked 2026-09-14).

Decodes a 17-character Vehicle Identification Number (VIN) into detailed vehicle specifications including make, model, engine, transmission, and plant data.

## Facts

- Endpoint: GET https://2s.io/api/vehicle/vin-decode
- Price: $0.0024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-vin-decode-ef0ea793
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s2YvBDfXyFqhHHIFDWpD5

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 2s-vin-decode-ef0ea793
```

Example prompt: Can you decode the VIN 1HGBH41JXMN109186 and tell me the make, model, engine, and where it was manufactured?

## When to prefer this

Use this endpoint when you need structured, programmatic vehicle data from a VIN without signing up for an API key or paying a monthly fee. Ideal for AI agents that occasionally need VIN lookups on a pay-per-call basis ($0.0024 USDC). Backed by NHTSA data, making it authoritative for US-market vehicles. Prefer over scraping or proprietary services when cost predictability and no-signup access are priorities.

## Known failure modes

- Invalid VIN format (not 17 chars, contains I/O/Q) — request rejected before payment
- VIN not found in NHTSA database — ok:true but empty items array
- Ambiguous model year due to VIN decade rollover — provide optional modelYear param to disambiguate
- Payment failure via x402 — no result returned
- Upstream NHTSA API unavailable — service error

## How this service works

Decode a 17-character VIN to manufacturer-supplied vehicle metadata via NHTSA's vPIC database. Returns identity (year, make, model, trim, series, body class, manufacturer), assembly plant (city, state, country), engine (cylinders, displacement, HP, fuel type, configuration, engine model), transmission (style, speeds), and body/weight specs. Curated to the ~30 fields agents actually use from vPIC's ~140-field response. Backed by NHTSA.gov; data is public-domain US government records.

## Output

A JSON object with ok:true and an items array containing one vehicle record with fields for VIN, make, model, trim, series, body class, manufacturer, assembly plant (city/state/country), engine (cylinders, displacement, HP, fuel type, configuration, model), transmission (style and speeds), doors, drive type, vehicle type, GVWR class, and model year. Also includes total count and source provenance (provider, URL, license).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "vin": "1HGBH41JXMN109186"
  }
 }
}
```

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "vin"
     ],
     "properties": {
      "vin": {
       "type": "string",
       "maxLength": 17,
       "minLength": 17,
       "description": "17-character VIN. Case-insensitive. Excludes letters I, O, and Q per VIN standard."
      },
      "modelYear": {
       "type": "integer",
       "maximum": 2099,
       "minimum": 1949,
       "description": "Optional model-year hint — disambiguates VINs where the year-digit wraps (A=1980/2010, etc.)."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-vin-decode-ef0ea793/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)