Vehicle history API

Vehicle history API: a full report in one request.

Give us a VIN and get its history back as JSON: how many owners, title brands such as salvage or rebuilt, reported accidents, odometer readings over time, open recalls and service events. Screen vehicles in code instead of reading PDFs.

Try it free API reference

Free on a new account: 5 × VIN Decode, 1 × Vehicle History and 1 × Window Sticker. No card required.

Python

import os, requests

res = requests.get(
    "https://api.autoparse.io/v1/vin/report/3FA6P0RU9HR306143",
    headers={"x-api-key": os.environ["AUTOPARSE_API_KEY"]},
    timeout=30,
)
res.raise_for_status()
print(res.json())

Overview

What is the Vehicle History API?

The Autoparse Vehicle History API returns a consolidated history report for a vehicle as JSON. You send one GET request to /v1/vin/report/{vin} with your API key, and the response lists the owners and their locations, title brands such as salvage or rebuilt, reported accidents with severity, odometer readings over time, open recalls and service events. Nine standard checks each carry a pass, warning, alert or info result, so your code can flag risk without reading the whole report. Because the output is structured, you can screen inventory automatically, spot odometer inconsistencies from dated readings and show buyers a clear summary. Each successful request costs a fixed number of credits shown on the pricing page. A VIN with no record, a provider error or a timeout is never billed. The API reference documents every field.

What you get

Structured data, not documents.

Ownership

Number of owners with location, usage type and dated events such as titles and registrations.

Title brands

Salvage, rebuilt and other brands reported against the vehicle.

Accidents

Severity, damage type and whether airbags deployed or the vehicle overturned.

Odometer

Dated mileage readings and checks across title, auction and calculated sources.

Recalls

Open manufacturer recalls that affect the vehicle.

Standard checks

Nine checks, each with a pass, warning, alert or info result you can act on directly.

Example response

What comes back.

A shortened real response for one VIN. Arrays and nested objects are trimmed here; the API reference shows every field.

200 OK

{
  "vin": "3FA6P0RU9HR306143",
  "checks": [
    {
      "name": "State Title Brand",
      "detail": "Salvage",
      "result": "alert",
      "status": "Title Brand Reported"
    },
    {
      "name": "Auction Brand / Issues",
      "result": "pass",
      "status": "No Issue"
    }
  ],
  "owners": [
    {
      "usage": "Personal",
      "events": [],
      "number": 1,
      "location": "CA",
      "owned_from": "03/2017"
    }
  ],
  "recalls": [],
  "vehicle": {
    "vin": "3FA6P0RU9HR306143",
    "name": "2017 Ford Fusion Platinum / Titanium",
    "engine": "2.0L I4 SMPI Gas/Electric Hybrid",
    "body_style": "Sedan 4D",
    "vehicle_class": "Car - Midsize",
    "vehicle_age_years": 9
  },
  "accidents": {
    "records": [
      {}
    ],
    "severity": "Moderate",
    "overturned": false,
    "airbag_deployed": false,
    "structural_damage": false
  },
  "inspections": [],
  "generated_at": "2026-11-02T10:45:30.339759+00:00"
}

Use cases

Built for the real workflow.

Marketplaces

Show buyers a transparent history summary on the listing page and build trust in your inventory.

Lenders

Screen for salvage titles and accident history before approving a vehicle loan.

Insurers

Flag odometer inconsistencies and prior damage at quote time.

Dealers and auctions

Check trade-ins and purchases quickly, before money changes hands.

How it works

Three steps to your first call.

Create an account and generate an API key.
Call GET /v1/vin/report/{vin} with your key in the x-api-key header.
Use the checks array for a quick risk flag, or the detailed sections for the full story.

Before you ship, read how to authenticate, how credits are charged, the rate limits and the error codes.

Pricing

36credits per successful request

From about $1.918 per request on the largest volumes. Subscribe for a monthly allowance or buy credit packs that never expire. Not found, upstream errors and timeouts are never billed.

See pricing

Questions

Vehicle History API, answered.

What does a vehicle history report include?

It covers ownership history, title brands such as salvage or rebuilt status, reported accidents with severity, odometer readings over time, open recalls, service history and market events like export or insurance transfers.

Is a VIN report the same as a vehicle history report?

Yes. People use both terms for the same thing: a report on a vehicle looked up by its VIN. This API returns it as JSON instead of a document.

How much does a vehicle history lookup cost?

A request costs a fixed number of credits, shown on the pricing page. You can subscribe for a monthly allowance or buy credit packs that never expire.

Am I charged when no history is found?

No. If a VIN has no record, the data provider errors or the request times out, you are not charged.