Owner complaints

Free and upView as Markdown

NHTSA owner complaints, summarized: totals, crashes, fires, injuries, deaths, counts by component and the ten most recent.

GEThttps://api.motorsdynamic.com/api/v2/complaints/{vin}

Plan and price

Plan	Access	Price
Free	Yes	included in the 1,000 monthly calls
Growth	Yes	$0.005 per call
Scale	Yes	$0.003 per call
Enterprise	Yes	contract

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

Parameters

Name	In	Type	Required	Description
`vin`	path	string	yes	17-character VIN (case-insensitive).

Example request

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

const res = await fetch("https://api.motorsdynamic.com/api/v2/complaints/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/complaints/1HGCM82633A004352",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response fields

Field	Type	Description
`meta`	object
`meta.reference_status`	`loaded` or `no_decode`	loaded = fetched from the source, so an empty result is real; no_decode = the VIN has no usable year, make and model. A model not fetched yet is 503 reference_data_pending.
`data`	object
`data.vin`	string
`data.vehicle`	object
`data.vehicle.year`	integer or null
`data.vehicle.make`	string or null
`data.vehicle.model`	string or null
`data.vehicle.trim`	string or null
`data.scope`	`year_make_model`
`data.vin_specific`	`false`
`data.total`	integer
`data.crashes`	integer
`data.fires`	integer
`data.injuries`	integer
`data.deaths`	integer
`data.latest_filed`	string or null
`data.by_component[]`	array of object
`data.by_component[].component`	string
`data.by_component[].count`	integer
`data.recent[]`	array of object
`data.recent[].odi_number`	integer or null
`data.recent[].date_filed`	string or null
`data.recent[].date_of_incident`	string or null
`data.recent[].components[]`	array of string
`data.recent[].crash`	boolean
`data.recent[].fire`	boolean
`data.recent[].injuries`	integer
`data.recent[].deaths`	integer
`data.recent[].summary`	string or null
`data.freshness`	object
`data.freshness.fetched_at`	string or null
`data.provenance`	object
`data.provenance.source`	`nhtsa_complaints`
`data.provenance.source_url`	string
`data.provenance.nhtsa_models[]`	array of string	The NHTSA model names this answer came from (NHTSA's names differ from the decode's: Silverado is SILVERADO 1500).

Errors

Status	Code	When
400	`invalid_parameter`	A parameter is missing or malformed. The message names it.
401	`invalid_api_key`	The key is missing, revoked or mistyped.
403	`not_entitled`	The key may not read this dealer or source.
404	`not_found`	Nothing matches the identifier in the path.
429	`rate_limited or quota_exceeded`	Slow down (see `Retry-After`), or the Free monthly calls are used up.
503	`error`	See the message.
504	`query_timeout`	The query passed its 4 second budget. Narrow the filters. Not billed.

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