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

# VIN Decoder API -- vehicle selections

`GET /v3/selections`

## Request

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

Get a standardized list of year, make, model, trim and style selections with names and IDs. Also accepts POST with the same parameters.

## Query parameters

- `list` string
- `id` string
- `year` integer
- `make` string
- `model` string
- `trim` string
- `style` string
- `format` 'json' | 'xml' | 'csv'
- `collection` 'in-market' | 'popular' | 'all'

## Response `200`

Selections tree (years > makes > models > trims > styles)

- object
  - `selections` object
    - `years` SelectionNode[]
      - `name` string
      - `id` string
      - `makes` SelectionNode[]
      - `models` SelectionNode[]
      - `trims` SelectionNode[]
      - `styles` SelectionNode[]
    - `makes` SelectionNode[]
      - `name` string
      - `id` string
      - `makes` SelectionNode[]
      - `models` SelectionNode[]
      - `trims` SelectionNode[]
      - `styles` SelectionNode[]
  - `error` string
  - `details` string

---

[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)