How to Look Up Vehicle Recalls by VIN in 3 Lines of Code

Source: Dev.to

The Quick Version

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.vehicle-finder.com/v1/recalls?vin=1HGCM82633A004352"

You get back structured JSON with every recall for that VIN – campaign number, description, remedy, completion status.

Why Not Use NHTSA Directly?

You can, but:

• NHTSA’s API returns XML by default and inconsistent JSON
• No authentication = no rate limiting = unreliable uptime
• Data is spread across multiple endpoints with different schemas
• No way to get recalls + TSBs + complaints in one place

Vehicle Finder API normalizes all of this into a consistent REST API with proper JSON responses, API‑key auth, and rate limiting.

Full Example (Python)

import requests

API_KEY = "vda_your_key_here"
BASE = "https://api.vehicle-finder.com/v1"

# Decode a VIN
vin = "1HGCM82633A004352"
vehicle = requests.get(f"{BASE}/vehicles/vin/{vin}",
    headers={"X-API-Key": API_KEY}).json()

print(f"Vehicle: {vehicle['data']['year']} {vehicle['data']['make']} {vehicle['data']['model']}")

# Get recalls
recalls = requests.get(f"{BASE}/recalls?vin={vin}",
    headers={"X-API-Key": API_KEY}).json()

for recall in recalls["data"]:
    print(f"Recall: {recall['component']}: {recall['summary']}")

What Else Can You Look Up?

Beyond recalls, the API covers:

• Oil change specs – type, capacity, filter part number
• Maintenance schedules – manufacturer‑recommended intervals
• Diagnostic codes – OBD‑II DTC descriptions and common fixes
• TSBs – Technical Service Bulletins from manufacturers
• Consumer complaints – crash/fire/injury reports from NHTSA
• Torque specs, towing capacity, fluid specs – and more

Getting Started

1. Sign up at vehicle-finder.com (free, 500 requests/month)
2. Confirm your email
3. Create an API key from the dashboard
4. Start making requests

Full documentation: api.vehicle-finder.com/docs

I built this because I needed it for my own project and figured other developers might too. The free tier is genuinely useful—500 requests/month is enough to build a side project or prototype. Feedback welcome!