---
title: "Lien & Theft records"
method: GET
path: "/v1/lien-theft"
tags: ["Lien & Theft"]
---

# Lien & Theft records

`GET /v1/lien-theft`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/v1/lien-theft`
- 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/v1/lien-theft/get.ts> (a function with typed inputs; its response is checked against the schema)

Check a VIN for active lien and theft records (US).

Credit plans: 5 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

## Response `200`

Lien/theft data retrieved.

- object
  - `success` boolean
  - `input` object
  - `timestamp` 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.
- `404`: No lien or theft data found for this VIN.
- `429`: API usage limit exceeded for the current billing period.

---

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