Vehicle Databases
🇬🇧en

VIN Suggestions API 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

GEThttps://api.vehicledatabases.com/vin-suggestion/v2/{vin}

Request

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

GET Parameters

VINRequired
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.

Example Response

status
success or error
data
Shows the list of suggested VIN numbers

Response

{
    "status": "success",
    "data": {
      "entered_vin": "2T1BU5EE3AC509614",
      "vin_status": "Invalid",
      "suggested_vin": "2T1BU4EE3AC509614",
      "year": "2010",
      "make": "TOYOTA",
      "model": "Corolla"
    }
  }

Error Responses

errorstatus

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

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.