---
title: "Vin Decoder"
method: GET
path: "/api/vin/{vin}"
tags: ["Vin Decoder"]
---

# Vin Decoder

`GET /api/vin/{vin}`

Decodes Vehicle Identification Numbers for vehicles sold in the United States. The result will include a list of
specifications in the `specs` property and a list of all possible trims matching the VIN in the `trims` property.
For non-paying users, all VINs for 2015-2020 models (e.g. 1GTG6CEN0L1139305) will be returned, otherwise data
is hidden. Paying users have full data access.

You may include body, engine, and mileage data to the matching trims by requesting `?verbose=yes`.

You may include all trims for the VINs model by requesting `?all_trims=yes`. By default, only trims
closely matching the requested VIN are returned.

## Path parameters

- `vin` string, required

## Query parameters

- `verbose` 'yes' | 'no'
- `all_trims` 'yes' | 'no'

## Response `200`

- object
  - `year` integer
  - `make` string
  - `model` string
  - `trim` string
  - `specs` object
  - `trims` object[]

## Other responses

- `400` — BadRequestException
- `405` — MethodNotAllowedException
- `429` — TooManyRequestsException - Max Per Minute: 600
- `503` — ServiceUnavailableException

---

[API](https://skmtc.net/carapi/apis/car-api-documentation.md) · [All operations](https://skmtc.net/carapi/apis/car-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carapi/car-api-documentation/revisions/5331e15a22af/schema)