Documentation

Welcome to Vehicle Databases API's Documentation

Windshield Lookup

GETJSON Response

Overview

This API returns detailed windshield specifications for a given vehicle using its VIN. The response includes the vehicle’s year, make, and model, NAGS, along with a list of compatible windshields.

COVERAGE

This API supports US/Canada VIN from year 1999 - present

SUPPORT

Works for all 17 digit VINs based in US and Canada region.

HTTP Request

Endpoint

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

Example — Python / Requests

Target:

Client:

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

GET Parameters

Parameter	Required	Description
vin	✓	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",
    "data": {
        "vin": "1FMCU9H61LUA94994",
        "year": "2020",
        "make": "Ford",
        "model": "Escape",
        "windshields": [
            {
                "nags_number": "DW02544",
                "oem_numbers": [
                    "LJ6Z7803100A",
                    "LJ6Z7803100E",
                    "LJ6Z7803100F",
                    "LJ6Z7803100L"
                ],
                "features": [
                    "Lane Departure"
                ],
                "calibrations": "Dynamic calibration"
            },
            {
                "nags_number": "DW02742",
                "oem_numbers": [
                    "LJ6Z7803100D",
                    "LJ6Z7803100J",
                    "LJ6Z7803100K",
                    "LJ6Z7803100M"
                ],
                "features": [
                    "Rain Sensor",
                    "Lane Departure"
                ],
                "calibrations": "Dynamic calibration"
            }
        ]
    }
}

Error Responses

error

status

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

< VIN Suggestions YMMT Specifications >

Navigation