Python: decode a VIN and list its model's recalls

"""Decode a VIN with RecallDB and list the recalls NHTSA filed for that model and year.

    pip install requests
    RECALLDB_KEY=rdb_... python3 vin_check.py 1HGCM82633A004352
"""
import os
import sys
from urllib.parse import urlparse

import requests

API = os.environ.get("RECALLDB_API", "https://recalldb.app")
HEADERS = {"Authorization": f"Bearer {os.environ['RECALLDB_KEY']}"}

vin = sys.argv[1] if len(sys.argv) > 1 else "1HGCM82633A004352"

# 1. Decode the VIN (it goes in the body, never in the URL; RecallDB does not store it).
r = requests.post(f"{API}/v1/vin", headers=HEADERS, json={"vin": vin}, timeout=20)
r.raise_for_status()
decoded = r.json()["data"]
if decoded["status"] != "ok":
    print(f"Could not use this VIN: {decoded['status']}")
    sys.exit(0)
car = decoded["vehicle"]
print(f"{car['year']} {car['make']} {car['model']}")

# 2. The model-year recalls. The decode answer links the model page; its path has the make and model ids.
_, _, make, model, year = urlparse(decoded["model_recalls_page"]).path.split("/")
r = requests.get(f"{API}/v1/vehicles/{make}/{model}/{year}", headers=HEADERS, timeout=20)
r.raise_for_status()
body = r.json()
recalls = body["data"]["recalls"]
print(f"{body['data']['recall_count']} recall(s) filed for this model and year:")
for rec in recalls:
    print(f"  {rec['date']}  {rec['id']}  {rec['component'] or ''}")
    print(f"      {rec['source']['official_url']}")

# Recalls are filed by model and year: not every car of this model is part of each one.
print("To check this exact car, enter the VIN at https://www.nhtsa.gov/recalls or ask the carmaker.")
print(f"{body['attribution']['text']} ({body['attribution']['url']})")

pip install requests
RECALLDB_KEY=rdb_your_key python3 vin_check.py 1HGCM82633A004352