---
title: "Vehicle History API -- generate a vehicle history report"
method: GET
path: "/v2/pullreport"
tags: ["VIN Data"]
---

# Vehicle History API -- generate a vehicle history report

`GET /v2/pullreport`

## Request

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

Generate a vehicle history report for a VIN. Reports are retained for 90 days -- reuse the same `id` with the same VIN to retrieve the same report without a new billable lookup. Also accepts POST with the same parameters.

## Query parameters

- `id` string, required
- `vin` string, required
- `user` string, required
- `pass` string, password, required
- `format` 'json' | 'xml' | 'pdf', required
- `mode` 'test'
- `type` 'USA' | 'CAN'
- `brand` 0 | 1
- `lang` 'en' | 'es'
- `callback` string

## Response `200`

Vehicle history report (JSON shown; XML and PDF also available)

- VehicleHistoryReport
  - `id` string
  - `vin` string
  - `date` string
  - `attributes` object
  - `titles` object[]
    - `date` string, date
    - `state` string
    - `vin` string
    - `meter` string
    - `meter_unit` 'M' | 'K'
    - `current` boolean
  - `jsi` object[]: Junk / salvage / insurance records.
  - `checks` object[]: Title brand records.
  - `lien` object[]: Lien, impound and export records (add-on).
  - `thefts` object[]: Theft and theft recovery records (add-on).
  - `salvage` object[]: Salvage auction records (add-on).
  - `accidents` object[]: Accident records (add-on).
  - `sale` object[]: Sale/listing records (add-on).
  - `clean` boolean: True if free of title brands, salvage and insurance records.
  - `success` boolean

---

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