Documentation

Welcome to Vehicle Databases API's Documentation

Title Check

GETJSON Response

Overview

Check title information of any vehicle with VIN It returns if the vehicle has salvage record or not on a particular date along with cause.

COVERAGE

All vehicles listed in North America.

SUPPORT

Works for all 17-Characters VINs. (US Region)

HTTP Request

Endpoint

GET https://api.vehicledatabases.com/title-check/{vin}

Example — Python / Requests

Target:
Client:
import requests
response = requests.get(
    "https://api.vehicledatabases.com/title-check/{vin}",
    headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())

GET Parameters

ParameterRequiredDescription
vin5-17 characters VIN number

JSON Response

The response is a JSON of all the information associated with a VIN number. Each vin number has the following elements:

Response Fields

ParameterDescription
status"success" or "error"
dataAn object containing all data available.
{
    "status": "success",
    "vin": "5TFDY5F18KX840724",
    "data": {
        "salvage": true,
        "salvage_details": [
            {
                "cause": "Collision",
                "date": "08-22-2023"
            }
        ]
    }
}
  
  

Error Responses

error
status

When an error occurs, the API returns an error status with a code and message.

CodeDescriptionResolution
400Record(s) were not found for this vehicle.Verify the VIN is correct or try a different vehicle.
401Access denied due to invalid subscription x-authkey.Provide a valid API x-authkey for an active subscription.
422Too many requestsReduce request frequency to comply with rate limits.
404API not foundCheck the API endpoint URL.
500BlankServer error. Contact support if the issue persists.