Skip to main content
POST
Lists the safety recalls issued for a make, model and model year, from the US National Highway Traffic Safety Administration: campaign number, report date, component, what is wrong, the risk, the remedy and whether owners are told to park the vehicle. These are the recalls for the model, not proof that a particular vehicle has had the repair done.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only.
string
required
The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only.
integer
required
The model year. At least 1950. Model year cannot be later than next year.
integer
The most recalls to return. From 1 to 50. Defaults to 25.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always vehicle_recalls
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US National Highway Traffic Safety Administration.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
string
Make.
string
Model.
number
Model year.
number
How many recalls were issued for the model, including any beyond limit.
object[]
Recalls.
string | null
The agency campaign number. null when the source gives no value.
string | null
The date the manufacturer reported the recall, YYYY-MM-DD. null when the source gives no value.
string | null
Component. null when the source gives no value.
string | null
What is wrong. null when the source gives no value.
string | null
The risk to the driver. null when the source gives no value.
string | null
What the manufacturer will do about it. null when the source gives no value.
string | null
Notes. null when the source gives no value.
string | null
Manufacturer. null when the source gives no value.
boolean
True when owners are told not to drive the vehicle.
boolean
True when owners are told to park the vehicle outside.
boolean
True when the remedy is a software update sent to the vehicle.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • Use it to check a used vehicle before a purchase, a loan, a claim or a fleet decision.
  • Covers vehicles sold in the United States.
  • To start from a vehicle identification number, decode it first with Vehicle Identification, which returns the make, model and year.
  • total is 0 when the model has no recalls.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}