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

ParameterRequiredDescription
VIN17 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.

ParameterDescription
statussuccess or error
dataShows 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
status

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

CodeDescriptionResolution
400No Record(s) were found.Verify the VIN is correct or try a different VIN.
401Invalid API x-authkey.Provide a valid API x-authkey.
404API endpoint not foundCheck the API endpoint URL.
429Rate limit exceededReduce request frequency to comply with rate limits.