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
| Parameter | Required | Description |
|---|---|---|
| vin | ✓ | 5-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
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
{
"status": "success",
"vin": "5TFDY5F18KX840724",
"data": {
"salvage": true,
"salvage_details": [
{
"cause": "Collision",
"date": "08-22-2023"
}
]
}
}
Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | Record(s) were not found for this vehicle. | Verify the VIN is correct or try a different vehicle. |
| 401 | Access denied due to invalid subscription x-authkey. | Provide a valid API x-authkey for an active subscription. |
| 422 | Too many requests | Reduce request frequency to comply with rate limits. |
| 404 | API not found | Check the API endpoint URL. |
| 500 | Blank | Server error. Contact support if the issue persists. |