# NHTSA vPIC VIN Decoder API

> Decode VINs (single or batch) and list vehicle makes, models and manufacturer codes

- Vendor: `nhtsavpicvindecoderapi` · version 1.0 · category Transport · tags vin decoder api, nhtsa vpic api, vehicle make model api, batch vin decode api, wmi lookup api, car specs api, vehicle data api, free vin api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/nhtsavpicvindecoderapi
- This document: https://apiclay.com/docs/nhtsavpicvindecoderapi.md
- OpenAPI 3.1: https://apiclay.com/api/nhtsavpicvindecoderapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `nhtsavpicvindecoderapi`
- Updated: 2026-11-18

## About

## NHTSA vPIC VIN Decoder API

Decode any 17-character VIN into make, model, year, trim, body class, engine, fuel type, plant and safety equipment, decode up to 50 VINs in one call, and browse makes, models and manufacturer (WMI) codes.

Data comes from **vpic.nhtsa.dot.gov** (https://vpic.nhtsa.dot.gov). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

Typical flow: `/makes` -&gt; `/models`, or `/decode-vin` directly

### Routes

#### GET `/decode-vin` - Decode one VIN
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| vin | path | string | yes | Full or partial VIN, e.g. `5YJ3E1EA7KF317000`. |
| modelyear | query | number | no | Model year, improves decoding of partial VINs. |

Returns: `Results[0]` with `Make`, `Model`, `ModelYear`, `Trim`, `BodyClass`, `DriveType`, `EngineCylinders`, `DisplacementL`, `FuelTypePrimary`, `PlantCountry`, `ErrorCode`, `ErrorText`.

#### POST `/decode-vin-batch` - Decode up to 50 VINs
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| DATA | body (form) | string | yes | VINs separated by `;`, optionally `VIN,year`, e.g. `5YJ3E1EA7KF317000;1HGCM82633A004105`. |

Returns: `Results[]`, one decoded record per VIN.

#### GET `/makes` - Makes for a vehicle type
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| vehicle_type | path | string | yes | e.g. `car`, `truck`, `motorcycle`, `bus`. |

Returns: `Results[]` with `MakeId`, `MakeName`.

#### GET `/models` - Models for a make and year
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| make | path | string | yes | Make name, e.g. `honda`. |
| year | path | number | yes | Model year, e.g. `2020`. |

Returns: `Results[]` with `Model_ID`, `Model_Name`, `Make_Name`.

#### GET `/wmi` - Manufacturer from WMI
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| wmi | path | string | yes | First 3 (or 6) VIN characters, e.g. `1HG`. |

Returns: `Results[0]` with `ManufacturerName`, `Make`, `VehicleType`, `CreatedOn`.

### License

vPIC data is published by the US Department of Transportation and is in the public domain.

### Caveats

- NHTSA answers in 1 to 6 seconds; batch and model lookups are the slowest.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by vpic.nhtsa.dot.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /decode-vin — Decode VIN
- Gateway: `GET https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/decode-vin`
- Public query params: `modelyear` (string), `vin` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /decode-vin-batch — Decode VINs in batch
- Gateway: `POST https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/decode-vin-batch`
- Public body fields: `DATA` (string, required)
- Body sample (JSON):

```json
{
  "DATA": "<DATA>"
}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /makes — Makes for vehicle type
- Gateway: `GET https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/makes`
- Public query params: `vehicle_type` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /models — Models for make and year
- Gateway: `GET https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/models`
- Public query params: `make` (string, required), `year` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /wmi — Decode WMI (manufacturer code)
- Gateway: `GET https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/wmi`
- Public query params: `wmi` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/nhtsavpicvindecoderapi/decode-vin?vin=<vin>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
