Documentation
Welcome to Vehicle Databases API's Documentation
VIN Suggestions
GETRate LimitedJSON Response
Overview
This API detects the error in the VIN digits and provides suggestions for the correct VINs including year,make and model.
COVERAGE
1981 to 2026.
SUPPORT
17 characters VIN number
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/vin-suggestion/v2/{vin}Example — Python / Requests
Target:
Client:
import requests
response = requests.get(
"https://api.vehicledatabases.com/vin-suggestion/v2/{vin}",
headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| VIN | ✓ | 17 characters VIN Number |
JSON Response
This API detects the error in the VIN digits and provides suggestions for the correct VINs including year,make and model.
| Parameter | Description |
|---|---|
| status | success or error |
| data | Shows the list of suggested VIN numbers |
Example Response
{
"status": "success",
"data": {
"entered_vin": "2T1BU5EE3AC509614",
"vin_status": "Invalid",
"suggested_vin": "2T1BU4EE3AC509614",
"year": "2010",
"make": "TOYOTA",
"model": "Corolla"
}
}Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | No Record(s) were found. | Verify the VIN is correct or try a different VIN. |
| 401 | Invalid API x-authkey. | Provide a valid API x-authkey. |
| 404 | API endpoint not found | Check the API endpoint URL. |
| 429 | Rate limit exceeded | Reduce request frequency to comply with rate limits. |