Open recalls

Asks the manufacturer's own VIN recall lookup which safety recalls are open on this car, and which it reports as repaired. Unlike /recalls/{vin} this is about the VIN (scope: vin, vin_specific: true). The manufacturer is asked when the car has not been checked in the last 7 days; the answer is stored and served until then (freshness.cached). Covered makes: Honda, Acura, Chevrolet, GMC, Buick, Cadillac; any other make is 404 open_recalls_not_supported. "None open" is only ever a manufacturer answer inside that window: when the manufacturer cannot be reached the answer is 502 source_unavailable, and a VIN it does not know is 404 vin_not_recognized_by_maker. Neither is billed. Always show provenance.manufacturer and freshness.checked_at with the result.

Plan and price

A call is billed when it answers 2xx. See pricing.

Parameters

Example request

curl "https://api.motorsdynamic.com/api/v2/openrecalls/1HGCM82633A004352" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/openrecalls/1HGCM82633A004352", {
  headers: { "x-api-key": process.env.MD_API_KEY },
});
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).error}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.get(
    "https://api.motorsdynamic.com/api/v2/openrecalls/1HGCM82633A004352",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response fields

Errors

Every error has the same body. Full list: errors.