DEV Community

michaelakoster
michaelakoster

Posted on

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

#apiwebdevtutorialpython

Ever needed to check if a vehicle has open safety recalls? The NHTSA has this data, but their API is... not developer-friendly.

I built Vehicle Finder API to make this dead simple.

The Quick Version 

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

That's it. 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']}")
Enter fullscreen mode Exit fullscreen mode

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 docs: 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!

Top comments (0)