Duaer

Get started

VIN decoder in Duaer

In Duaer: US NHTSA vPIC: make, model, year, body, engine, fuel, and plant from a 17-character VIN. One successful search uses 1 credit.

What you get

Duaer VIN decoder decodes one vehicle identification number with NHTSA vPIC and returns one row of vehicle facts.

Pick Duaer Data → VIN decoder in the node creator, or open the data market. Related: Vehicle recalls, EIA fuel spot prices.

When to use it

  • Fill in make, model, and year from a VIN on a form.
  • Check the engine and fuel type of a used car.

When not to use it

Search on the canvas

  1. Open the node creator and pick Duaer Data → VIN decoder.
  2. Fill VIN (such as 1HGCM82633A004352).
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/vin-decode?vin=1HGCM82633A004352
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-vin-decode
description: >-
  Duaer VIN decoder. US NHTSA vPIC: make, model, year, body, engine, fuel, and plant from a 17-character VIN.
  One successful search uses 1 Duaer credit.
---

# Duaer VIN decoder

Duaer VIN decoder decodes one vehicle identification number with NHTSA vPIC and returns one row of vehicle facts.

## When to use

- Fill in make, model, and year from a VIN on a form.
- Check the engine and fuel type of a used car.

## When not to use

- Safety recalls. Use https://skills.duaer.com/vehicle-recalls.md.
- Fuel prices. Use https://skills.duaer.com/eia-petroleum.md.

## Call

`GET https://api.duaer.com/v1/data/vin-decode?vin=1HGCM82633A004352`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `vin`.

- `vin` — 17-character vehicle identification number.

## Examples

- `GET https://api.duaer.com/v1/data/vin-decode?vin=1HGCM82633A004352` — a 2003 Honda Accord.
- `GET https://api.duaer.com/v1/data/vin-decode?vin=5YJ3E1EA7KF317000` — a Tesla Model 3.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `vin`, `make`, `model`, `modelYear`, `trim` — vehicle identity.
- `bodyClass`, `vehicleType`, `doors` — body.
- `fuel`, `engineCylinders`, `displacementL`, `engineHp`, `transmission` — drivetrain.
- `manufacturer`, `plantCountry`, `plantCity`, `decodeNote` — maker, plant, and any decode warning.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/vehicle-recalls.md — Duaer Vehicle recalls
- https://skills.duaer.com/eia-petroleum.md — Duaer EIA fuel spot prices

Questions

How many credits does a VIN decoder search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Does Duaer VIN decoder work for cars sold outside the US?

It mainly covers vehicles sold in the US. Others may decode only in part; decodeNote explains.

In this section

Get started

Vehicle recalls in Duaer

In Duaer: US NHTSA: safety recalls for a vehicle make, model, and model year, with the defect, risk, and remedy. One successful search uses 1 credit.

Get started

EIA fuel spot prices in Duaer

In Duaer: US EIA: spot prices for WTI and Brent crude, gasoline, diesel, heating oil, jet fuel, and propane. One successful search uses 1 credit.