---
title: "Vehicle History"
method: GET
path: "/history"
tags: ["History"]
---

# Vehicle History

`GET /history`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/history`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `PAYMENT-SIGNATURE`
  - none
- TypeScript: <https://skmtc.dev/carsxe/apis/carsxe-api/docs/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a vehicle history report by VIN, including title, brand, junk/salvage and insurance records.

Credit plans: 25 credits per successful billable lookup. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md for billing units.

## Query parameters

- `vin` string, required
- `format` 'json' | 'xml'
- `lienTheft` 'true' | '1'

## Response `200`

History report retrieved.

- object
  - `success` boolean
  - `vin` string
  - `junkAndSalvageInformation` object[]
  - `insuranceInformation` object[]
  - `brandsRecordCount` number
  - `brandsInformation` object[]
  - `vinChanged` boolean
  - `currentTitleInformation` object[]
  - `historyInformation` object[]
  - `lienTheft` object: Present only with `lienTheft=true`. On success, the `/v1/lien-theft` body without `input` and `timestamp`; otherwise `success: false` with a `message`.
    - `success` boolean
    - `message` string
    - `year` integer
    - `make` string
    - `model` string
    - `type` string
    - `events` object[]
    - `trim_data` object

## Other responses

- `400`: Missing or invalid VIN.
- `401`: Missing API key, unknown/disabled API key, or inactive account.
- `403`: This API key has been blocked for the History API.
- `404`: No history data found for this VIN.
- `429`: API usage limit exceeded for the current billing period.
- `500`: Internal server error.

## Changes

- **2026-10-23** `ac8fcb028169`: 2 info
  - added the new optional `query` request parameter `lienTheft`
  - added the optional property `lienTheft` to the response with the `200` status

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

---

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