Recalls

NHTSA recall campaigns issued for the car's model year, make and model (scope: year_make_model). This is not a per-VIN result: it does not say whether this car is included in a campaign or has been repaired. Until the year, make and model has been fetched from NHTSA the answer is 503 reference_data_pending. When NHTSA answered nothing for the model under any name we tried, in any dataset, the answer is 404 reference_no_match: an empty list is returned only for a model NHTSA is known to carry. Neither is billed.

Plan and price

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

Parameters

Example request

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

const res = await fetch("https://api.motorsdynamic.com/api/v2/recalls/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/recalls/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.