VIN Decoder API - Full Reference

Authentication

All requests require authentication using your API username and secret key.

Example authenticated request:

GET https://vindecodervehicle.com/api/?user=youruser&key=yourkey&vin=WF0GXXGAJ69C71882

Rate Limits & Plans

Limits are enforced per user per month (rolling 30 days).

Upgrade anytime from your dashboard or the API page for higher limits and OEM/Repair data.

1. Decode VIN (primary result)

Parameters:

Example:

GET https://vindecodervehicle.com/api/?user=youruser&key=yourkey&vin=WF0GXXGAJ69C71882

Sample Response (simplified):

{
  "success": true,
  "data": {
    "carId": "1888",
    "make": "FORD",
    "model": "RANGER",
    "year": "2006",
    "description": "2.5 TDCi 4x4",
    "fuel": "Diesel",
    "powerHpFrom": "143"
  }
}

2. Decode VIN (all possible matches)

Returns every possible vehicle match for the VIN prefix.

3. Get Vehicle by carId

Detailed specs for a specific vehicle ID (from previous decode).

4. Fluid Capacities

Returns service fluid quantities (oil, coolant, brake fluid, etc.).

Example Response:

[
  {
    "ItemMPText": "Engine oil",
    "QualColTextStr": "SAE 5W-30",
    "ValueText": "5.5",
    "ADQuantityTextStr": "liters",
    "AddTextStr": "With filter"
  }
]

5. OEM Parts & Repair Times (Paid Plans)

Available on paid plans. Returns original manufacturer parts and standard labor times.

6. List Brands, Models & Variants

• ?brands=1 — All supported brands
• ?brand=ford&models=1 — Models for a brand
• ?brand=ford&model=fiesta&variants=1 — Variants for a model

See the Database page for a visual overview of popular brands.

Error Codes

JavaScript (Fetch)

fetch('https://vindecodervehicle.com/api/?user=YOUR_USER&key=YOUR_KEY&vin=WF0GXXGAJ69C71882')
  .then(r => r.json())
  .then(data => {
    if (data.success) console.log(data.data);
  });

PHP (cURL)

$url = "https://vindecodervehicle.com/api/?user=USER&key=KEY&vin=WF0GXXGAJ69C71882";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Python

import requests
r = requests.get("https://vindecodervehicle.com/api/", params={
    "user": "YOUR_USER", "key": "YOUR_KEY", "vin": "WF0GXXGAJ69C71882"
})
print(r.json())

cURL

curl "https://vindecodervehicle.com/api/?user=YOUR_USER&key=YOUR_KEY&vin=WF0GXXGAJ69C71882"

Official SDKs

Official client libraries for faster integration:

• JavaScript SDK
• Node.js SDK
• PHP SDK
• Python SDK

See all SDKs on the main API page →