# VIN Decode

> Full reference for the decode_vin_neovin tool — decode any 17-character VIN to get comprehensive vehicle specifications, MSRP, installed options, features, and more.

Decode a Vehicle Identification Number (VIN) to retrieve comprehensive vehicle specifications using the NeoVIN decoder. This provides richer data than standard VIN decoders — including trim-level details, installed options, factory pricing, and feature lists.



## Overview

| Property | Value    |
|----------|----------|
| Tool name | `decode_vin_neovin` |
| Required | VIN (17 characters) |
| API endpoint | `GET /v2/decode/car/neovin/{vin}/specs` |
| Data quality | Includes trim, options, MSRP — beyond standard VIN decoders |




## Parameters

| Parameter   | Type        | Default     | Required    | Description |
|-------------|-------------|-------------|-------------|-------------|
| `vin` | string | — | **Yes** | 17-character Vehicle Identification Number |
| `include_generic` | bool | `false` | No | Include generic vehicle data in the response |




## Response Data

The decoded response covers the full vehicle profile:

| Category        | Fields Included |
|-----------------|-----------------|
| **Identity** | Year, make, model, trim, version |
| **Engine** | Engine type, displacement, cylinders, block, aspiration, horsepower, torque |
| **Transmission** | Type, number of speeds |
| **Drivetrain** | AWD, FWD, RWD, 4WD |
| **Dimensions** | Overall height, length, width, wheelbase |
| **Weight** | Curb weight, GVWR |
| **Fuel Economy** | City MPG, highway MPG, combined MPG |
| **Pricing** | Base MSRP, destination charge |
| **Installed Options** | Factory-installed packages and features for this specific VIN |
| **Available Options** | Optional packages offered for the trim level |
| **Colors** | Standard and available interior/exterior colors |
| **Seating** | Standard seating capacity |
| **Powertrain** | Classification (BEV, HEV, PHEV, Combustion, etc.) |
| **Confidence** | Data confidence ratings for decoded fields |




## Use Cases



### Decode a VIN for full specs

```text
decode_vin_neovin(
  vin="WDDGF8AB0DR298788"
)
```



### Include generic vehicle data

```text
decode_vin_neovin(
  vin="WDDGF8AB0DR298788",
  include_generic=true
)
```



## Common Workflow

VIN decoding is typically the **first step** in vehicle research. Use the decoded specs to inform subsequent searches and valuations:

1. **Decode VIN** — `decode_vin_neovin(vin=...)` to confirm all specs, trim, options, and MSRP
2. **Predict price** — `predict_price_with_comparables(vin=..., miles=...)` for market valuation
3. **Check history** — `get_car_history(vin=...)` for past listing data
4. **Find comparables** — `search_active_cars(make=..., model=..., trim=..., year=...)` using exact values from the decode



## See Also

- [Price Prediction](/docs/get-started/api/mcp/tools/predict-price) — Market valuation using decoded vehicle data
- [Car History](/docs/get-started/api/mcp/tools/car-history) — Track how a vehicle has been listed over time
- [NeoVIN API](/docs/api/cars/vehicle-specs/neovin) — Underlying REST API documentation