Build Faster with
Better Docs

The Developer Experience Revolution

In 2025, Developer Experience (DevEx) is the new competitive advantage. We know that you don't want to spend hours reading dense PDFs or debugging cryptic error messages. You want to ship code.

That's why we've embraced the "Back to Basics" trend. No complex SOAP envelopes. No proprietary SDKs required. Just standard, clean REST APIs that work with curl, fetch, or requests.

Recent surveys show that 84% of developers are now using AI tools like Copilot or ChatGPT to write code. Our documentation is optimized for this AI-driven world. Our examples are clear, context-rich, and easy for LLMs to parse and implement for you.

Authentication

We use standard Bearer Token authentication. It's simple and secure.

# Pass your API key in the Authorization header
curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.vehicledatabases.com/v1/vin/decode?vin=..."

You can generate and manage your API keys in the Dashboard. We recommend rolling your keys periodically for security.

Rate Limiting

To ensure fair usage and stability, we enforce rate limits based on your plan.

• Developer Plan: 1 request per second.
• Startup Plan: 10 requests per second.
• Enterprise Plan: Custom limits (up to 10,000+ RPS).

We return standard X-RateLimit-* headers so your application can handle backpressure gracefully. If you hit a limit, you'll receive a 429 Too Many Requests response.

Handling Errors

We use standard HTTP status codes. No guessing.

• 200 OK: Success.
• 400 Bad Request: You sent an invalid VIN or missing parameter.
• 401 Unauthorized: Your API key is invalid or missing.
• 404 Not Found: The VIN was not found in our database.
• 500 Internal Server Error: Something went wrong on our end (rare!).

Quickstart: Python

Here is a complete example of how to decode a VIN using Python and the requests library.

import requests

API_KEY = "your_api_key_here"
VIN = "1G1ZC5E0..."
URL = "https://api.vehicledatabases.com/v1/vin/decode"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.get(URL, headers=headers, params={"vin": VIN})

if response.status_code == 200:
    data = response.json()
    print(f"Vehicle: {data['year']} {data['make']} {data['model']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

Quickstart: Node.js

And here is the same example using modern JavaScript (ESM).

const API_KEY = 'your_api_key_here';
const VIN = '1G1ZC5E0...';
const URL = `https://api.vehicledatabases.com/v1/vin/decode?vin=${VIN}`;

try {
    const response = await fetch(URL, {
        headers: {
            'Authorization': `Bearer ${API_KEY}`,
            'Content-Type': 'application/json'
        }
    });

    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log(`Vehicle: ${data.year} ${data.make} ${data.model}`);
} catch (error) {
    console.error('Error decoding VIN:', error);
}

Postman Collection

Prefer to test visually? Download our Postman Collection to explore all endpoints without writing a single line of code.