---
title: "Vin decoder and Recall Info"
method: GET
path: "/vinDecode"
tags: ["Vehicle Data", "Starter Plan Or Greater"]
---

# Vin decoder and Recall Info

`GET /vinDecode`

Decodes the provided North American vin and provides recall information if available. 
We require at least the first 12 out of 17 characters in the vin to attempt a decode. The vin is not case sensitive.
If passEmpty (default False) is True we will also include the empty fields in the response json. 
If includeRecall (default True) is True we will include recall data reported to the NHTSA. Set False for a faster response.

## Query parameters

- `jwt` string, required
- `vin` string, required
- `passEmpty` boolean
- `includeRecall` boolean

## Response `200`

Successful Response

- GenericResponse
  - `brandName` string
  - `modelName` string
  - `regionName` string
  - `condition` string
  - `msg` string
  - `cacheTimeLimit` integer
  - `data` unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/autodealerdata/apis/cis-automotive-api.md) · [All operations](https://skmtc.dev/autodealerdata/apis/cis-automotive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/autodealerdata/cis-automotive-api/revisions/ffe19d0f3ae1/schema)