---
title: "Vehicle History API -- query a VIN for records"
method: GET
path: "/v2/query"
tags: ["VIN Data"]
---

# Vehicle History API -- query a VIN for records

`GET /v2/query`

## Request

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

Decode a VIN (model years 1981+) and get a report ID to reuse with /v2/pullreport and /v2/report. Requires an API bulk access account.

## Query parameters

- `vin` string, required
- `user` string, required
- `pass` string, password, required
- `format` 'json' | 'xml', required
- `skipspec` 0 | 1
- `mode` 'test'
- `callback` string

## Response `200`

VIN query result

- object
  - `id` string: Report ID to reuse with /v2/pullreport or /v2/report
  - `vin` string
  - `attributes` object
  - `success` boolean
  - `error` string
  - `error_message` 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)