---
title: "VIN Decoder API -- vehicle specifications"
method: GET
path: "/v3/specifications"
tags: ["VIN Data"]
---

# VIN Decoder API -- vehicle specifications

`GET /v3/specifications`

## Request

- Base URL: `https://specifications.vinaudit.com`
- URL: `https://specifications.vinaudit.com/v3/specifications`
- Auth: API key in query parameter `key`
- TypeScript: <https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/docs/v3/specifications/get.ts> (a function with typed inputs; its response is checked against the schema)

Get vehicle attributes, equipment, colors, recalls, warranties and photos by VIN, by year/make/model/trim, or by ID. Also accepts POST with the same parameters.

## Query parameters

- `vin` string
- `year` integer
- `make` string
- `model` string
- `trim` string
- `id` string
- `include` string
- `format` 'json' | 'xml'

## Response `200`

Vehicle specifications

- object
  - `input` object
  - `selections` object
  - `attributes` object
  - `colors` object[]
    - `category` string
    - `name` string
  - `equipment` object[]
    - `group` string
    - `name` string
    - `availability` string
  - `recalls` object[]
  - `warranties` object[]
  - `photos` object[]

---

[API](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis.md) - [All operations](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/revisions/1f1500e74b46?raw)