# OneShot Agent API – VIN Lookup / Vehicle Identification

> OneShot Agent API – VIN Lookup / Vehicle Identification is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Decodes a 17-character VIN into full vehicle specification details including make, model, trim, body class, engine, and plant information

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-vin-lookup-vehicle-identification-5d30d082
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KvgNumIgN-aqb2VlnttpL

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 oneshot-agent-api-vin-lookup-vehicle-identification-5d30d082 -d '<json body>'
```

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

## When to prefer this

Choose this endpoint when you need to decode a raw VIN string into structured vehicle metadata — particularly make, model, trim, engine, and manufacturing details — without needing to pass through a DMV or registry. It is ideal for automotive research, fleet management, insurance verification, or any workflow where a VIN is the only known identifier and full vehicle specs are needed. At $0.005 per call with no API key required, it is well-suited for high-volume or ad-hoc agent workflows using x402 micropayments on Base.

## Known failure modes

- Invalid or malformed VIN (not 17 characters) returns decoded=false
- Ambiguous model year in position 10 may require model_year parameter to resolve correctly
- Unknown or unrecognized VIN may return partial data with decoded=false
- Payment failure over x402 if insufficient USDC balance
- Network timeout or service unavailability

## How this service works

Decode a vehicle identification number into make, model, year and build details.

## Output

Returns a JSON object with fully decoded vehicle information including VIN, make, model, trim, series, body class, doors, fuel type, drive type, transmission, engine cylinders, engine horsepower, engine displacement in liters, vehicle type, manufacturer name, plant city/state/country, model year, GVWR rating, check digit validity, decoded flag, notes, and a suggested VIN if the original had issues.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vin": {
   "type": "string",
   "description": "The vehicle identification number. A VIN is 17 characters: digits and capital letters, never I, O or Q."
  },
  "model_year": {
   "type": "integer",
   "description": "Model year, when known. Resolves the year for numbers where position 10 is ambiguous. From 1981 to 2100."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vin": "1HGCM82633A004352",
  "make": "HONDA",
  "trim": "EX-V6",
  "doors": 2,
  "model": "Accord",
  "notes": [],
  "series": null,
  "decoded": true,
  "fuel_type": "Gasoline",
  "body_class": "Coupe",
  "drive_type": null,
  "model_year": 2003,
  "plant_city": "MARYSVILLE",
  "plant_state": "OHIO",
  "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
  "transmission": "Automatic",
  "vehicle_type": "PASSENGER CAR",
  "plant_country": "UNITED STATES (USA)",
  "suggested_vin": null,
  "engine_cylinders": 6,
  "check_digit_valid": true,
  "engine_horsepower": 240,
  "engine_displacement_l": 3,
  "gross_vehicle_weight_rating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-vin-lookup-vehicle-identification-5d30d082/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)