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

# GET /vin/{vin}

`GET /vin/{vin}`

## Request

- Base URL: `https://api.auto.dev`
- URL: `https://api.auto.dev/vin/{vin}`
- Auth: none declared

The /vin (and /data) decode of a VIN our tables know (services/data.vin.ts).

## Path parameters

- `vin` string, required: Vehicle Identification Number

## Query parameters

- `ambiguity` boolean

## Response `200`

Success

- object: The /vin (and /data) decode of a VIN our tables know (services/data.vin.ts).
  - `api` API
    - `description` string, required
    - `from` string, required
    - `login` string, required
    - `name` string, required
    - `repo` string, required
    - `signup` string, required
    - `type` string, required
    - `url` string, required
  - `ambiguous` boolean, required: Whether the VIN corresponds to multiple possible vehicle trims or styles. When true, style is null, trim is null unless our sources settle it, and trims and styles list the possibilities
  - `body` string: Vehicle body class
  - `checkDigit` string, required: The 9th character used for VIN validation
  - `checksum` boolean, required: Whether the VIN checksum is valid
  - `drive` string: Drivetrain configuration
  - `engine` string: Engine description
  - `make` string, required: Vehicle manufacturer
  - `model` string, required: Vehicle model name
  - `origin` string, required: Country of manufacture
  - `squishVin` string, required: 10-character squish VIN (positions 1-8 + 10-11 of the full VIN)
  - `style` unknown, required
  - `styles` AmbiguousStyle[]: Present only when the VIN matches more than one style: each one, most likely first
    - `confidence` number: Estimated share of this style among current listings of the model and year (0-1); absent when there are none
    - `name` string, required: Style name
    - `trim` string: The style's trim
  - `transmission` string: Transmission type
  - `trim` unknown, required
  - `trims` string[]: Present only when the VIN matches more than one style: every trim among them, most likely first
  - `type` string, required: Vehicle type classification
  - `vehicle` VinVehicle, required
    - `make` string, required: Vehicle manufacturer
    - `manufacturer` string: Full manufacturer name
    - `model` string, required: Vehicle model name
    - `vin` string, required: Vehicle Identification Number
    - `year` number, required: Model year
  - `vin` string, required: Vehicle Identification Number
  - `vinValid` boolean, required: Whether the VIN is valid and properly formatted
  - `wmi` string, required: World Manufacturer Identifier (first 3 characters)
  - `year` number, required: Model year
  - `yearAmbiguous` boolean: Whether more than one model year fits the VIN (see years)
  - `years` number[]: Every model year that fits the VIN
  - `user` ApiUser
    - `accessState` 'active' | 'suspended'
    - `admin` boolean
    - `authenticated` boolean, required
    - `browser` string
    - `city` string, required
    - `continent` string, required
    - `country` string, required
    - `edgeDistanceKilometers` number
    - `edgeDistanceMiles` number
    - `edgeLocation` string, required
    - `email` string
    - `enterprise` boolean
    - `flag` string, required
    - `image` string
    - `ip` string, required
    - `isp` string, required
    - `latencyMilliseconds` number, required
    - `localTime` string, required
    - `metro` string, required
    - `name` string
    - `org` string
    - `os` string, required
    - `plan` 'Free' | 'Starter' | 'Growth' | 'Scale' | 'Enterprise', required
    - `recentInteractions` number, required
    - `region` string, required
    - `requestId` string, required
    - `serviceLatency` number
    - `spendCap` number
    - `support` string
    - `timezone` string, required
    - `trustScore` number, required
    - `upgrade` string
    - `userAgent` string
    - `zipcode` string

## Changes

- **2026-10-21** `023021481d0f`: 1 breaking
  - removed the required property `styles/items/styleId` from the response with the `200` status
- **2026-10-21** `50a9d266af41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/auto/apis/drivly-api/changes/vin/:vin/get.md)

---

[API](https://skmtc.dev/auto/apis/drivly-api.md) - [All operations](https://skmtc.dev/auto/apis/drivly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/auto/apis/drivly-api/revisions/fc7660e79a56?raw)