Vehicle Recalls (NHTSA)
NHTSA safety recalls for a vehicle model, by VIN or by make, model and model year: campaign number, component, summary, consequence, remedy and park-it advisories, newest first.
- Price per call
- 1 credit
- per successful call
- Price ceiling
- 1 credit
- every call, same price
- Failed calls
- Free
- retried automatically
- Billed
- Per call
- only on success
Endpoint
api.primaryapi.com/ v1/ run/ vin. recallsAuth: API key with run or full access, or a dashboard session
Send the input below as a JSON body. The call is routed to a healthy upstream; if an attempt fails, it is retried automatically inside the same request and you pay only for the answer you get. To check an input and see the exact price without running anything, call POST /v1/quote/vin.recalls with the same body (free).
Example request
curl -sS -X POST "https://api.primaryapi.com/v1/run/vin.recalls" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"make":"honda","model":"accord","modelYear":2003}'const res = await fetch('https://api.primaryapi.com/v1/run/vin.recalls', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PRIMARYAPI_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
make: 'honda',
model: 'accord',
modelYear: 2003,
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.error}`);
// found:false is a successful answer ("does not exist"), not an error
console.log(body.output.found ? body.output.data : body.output.reason, body.credits);import os
import requests
res = requests.post(
"https://api.primaryapi.com/v1/run/vin.recalls",
headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"},
json={
"make": "honda",
"model": "accord",
"modelYear": 2003,
},
timeout=60,
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['code']}: {body['error']}")
# found=False is a successful answer ("does not exist"), not an error
print(body["output"]["data"] if body["output"]["found"] else body["output"]["reason"], body["credits"]){
"name": "run_api",
"arguments": {
"sku": "vin.recalls",
"input": {
"make": "honda",
"model": "accord",
"modelYear": 2003
}
}
}Price this exact input first (free)
curl -sS -X POST "https://api.primaryapi.com/v1/quote/vin.recalls" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"make":"honda","model":"accord","modelYear":2003}'Returns credits (what the call is expected to cost) and maxCredits (the most it can cost, which is set aside while it runs). Invalid input fails here the same way it would on run.
Input
JSON body fields. Unknown fields are rejected with 400 invalid_input (never silently ignored). You may add the routing controls preferLatencyUnderMs and maxCredits to the same object.
vinstring- 17-character VIN. It is decoded to make, model and model year, and recalls are listed for that vehicle model (not this exact car).pattern: ^[A-HJ-NPR-Z0-9]{17}$
makestring- Vehicle make, e.g. "honda" (with model and modelYear, when no VIN is given).max 50 chars
modelstring- Vehicle model, e.g. "accord".max 60 chars
modelYearinteger- Model year, e.g. 2003.1949–2100
Output
When output.found is true, output.data has these fields (a list under recalls, billed per item returned).
vehicleobject- The vehicle model the recalls were looked up for
vehicle.vinstring | null- The VIN given (upper case), null for a make/model/year call
vehicle.makestringvehicle.modelstringvehicle.modelYearintegercountinteger- Recalls listed
recallsobject[]- Recalls for the model, newest report first
recalls[].agencyenum- Agency that published the recallone of: cpsc, fda, nhtsa
recalls[].recallIdstring- Agency recall id: CPSC recall number, FDA recall number, NHTSA campaign number
recalls[].datestring- Recall date (CPSC), report date (FDA) or report received date (NHTSA), YYYY-MM-DD
recalls[].titlestring- Recall title (CPSC), "<firm>: <product>" (FDA) or the component (NHTSA)
recalls[].categorystring | null- CPSC product type, FDA category (drug, device, food) or "vehicle" (NHTSA)
recalls[].classificationstring | null- FDA recall class (Class I is the most serious); null for other agencies
recalls[].statusstring | null- FDA recall status (Ongoing, Completed, Terminated); null for other agencies
recalls[].firmsstring[]- Recalling firm(s): manufacturer, importer or distributor names
recalls[].productsstring[]- Product names (NHTSA: "MAKE MODEL YEAR")
recalls[].hazardstring | null- Hazard (CPSC), reason for recall (FDA) or consequence (NHTSA)
recalls[].remedystring | null- What owners should do (CPSC, NHTSA); null for FDA
recalls[].descriptionstring | null- Description (CPSC), product description (FDA) or summary (NHTSA)
recalls[].unitsstring | null- Units affected as published, e.g. "About 265,000" or "18,991 vials"
recalls[].urlstring | null- Agency recall notice URL when the agency publishes one (CPSC)
recalls[].campaignNumberstring- NHTSA campaign number, e.g. "19V182000" (same as recallId)
recalls[].manufacturerstring | null- Manufacturer that filed the recall
recalls[].componentstring | null- Affected component, e.g. "AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE"
recalls[].summarystring | nullrecalls[].consequencestring | nullrecalls[].notesstring | nullrecalls[].nhtsaActionNumberstring | null- Related NHTSA investigation, e.g. "EA15001"
recalls[].parkItboolean | null- NHTSA advises not to drive the vehicle until repaired
recalls[].parkOutsideboolean | null- NHTSA advises parking outside (fire risk) until repaired
recalls[].overTheAirUpdateboolean | null- The remedy is delivered over the air
nextCursornull
TypeScript type
/** output.data when output.found is true */
type VinRecalls = {
/** The vehicle model the recalls were looked up for */
vehicle: {
/** The VIN given (upper case), null for a make/model/year call */
vin: string | null;
make: string;
model: string;
modelYear: number;
};
/** Recalls listed */
count: number;
/** Recalls for the model, newest report first */
recalls: {
/** Agency that published the recall */
agency: "cpsc" | "fda" | "nhtsa";
/** Agency recall id: CPSC recall number, FDA recall number, NHTSA campaign number */
recallId: string;
/** Recall date (CPSC), report date (FDA) or report received date (NHTSA), YYYY-MM-DD */
date: string;
/** Recall title (CPSC), "<firm>: <product>" (FDA) or the component (NHTSA) */
title: string;
/** CPSC product type, FDA category (drug, device, food) or "vehicle" (NHTSA) */
category: string | null;
/** FDA recall class (Class I is the most serious); null for other agencies */
classification: string | null;
/** FDA recall status (Ongoing, Completed, Terminated); null for other agencies */
status: string | null;
/** Recalling firm(s): manufacturer, importer or distributor names */
firms: string[];
/** Product names (NHTSA: "MAKE MODEL YEAR") */
products: string[];
/** Hazard (CPSC), reason for recall (FDA) or consequence (NHTSA) */
hazard: string | null;
/** What owners should do (CPSC, NHTSA); null for FDA */
remedy: string | null;
/** Description (CPSC), product description (FDA) or summary (NHTSA) */
description: string | null;
/** Units affected as published, e.g. "About 265,000" or "18,991 vials" */
units: string | null;
/** Agency recall notice URL when the agency publishes one (CPSC) */
url: string | null;
/** NHTSA campaign number, e.g. "19V182000" (same as recallId) */
campaignNumber: string;
/** Manufacturer that filed the recall */
manufacturer: string | null;
/** Affected component, e.g. "AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE" */
component: string | null;
summary: string | null;
consequence: string | null;
notes: string | null;
/** Related NHTSA investigation, e.g. "EA15001" */
nhtsaActionNumber: string | null;
/** NHTSA advises not to drive the vehicle until repaired */
parkIt: boolean | null;
/** NHTSA advises parking outside (fire risk) until repaired */
parkOutside: boolean | null;
/** The remedy is delivered over the air */
overTheAirUpdate: boolean | null;
}[];
nextCursor: null;
};If what you asked about does not exist, is private, or a search matches nothing, the call still succeeds: output.found is false, output.data is null and output.reason says why. Such misses are free unless the notes below say misses are billed, in which case a miss costs the price of one call.
Example response
Values are placeholders that follow the output schema (strings as "string", numbers as 0); credits shows what this call would cost at the usual price.
{
"output": {
"found": true,
"data": {
"vehicle": {
"vin": null,
"make": "HONDA",
"model": "ACCORD",
"modelYear": 2003
},
"count": 24,
"recalls": [
{
"agency": "nhtsa",
"recallId": "19E068000",
"date": "2019-10-10",
"title": "VEHICLE SPEED CONTROL:ACCELERATOR PEDAL",
"category": "vehicle",
"classification": null,
"status": null,
"firms": [
"Dorman Products, Inc."
],
"products": [
"HONDA ACCORD 2003"
],
"hazard": "If the accelerator pedal binds, the engine may not quickly return to idle after the pedal is no longer pressed, increasing the risk of a crash.",
"remedy": "Dorman will notify owners, and qualified service facilities will replace the affected accelerator pedal assemblies, free of charge. The recall began December 9, 2019. Owners may contact Dorman customer service at 1-800-523-2492, using option 5. Dorman's number for this recall is AS1019XXXX.",
"description": "Dorman Products, Inc. (Dorman) is recalling certain Accelerator Pedal Assemblies part numbers 699-114 and 825-5029-1, sold as replacement parts for 2003-2006 Acura MDX, 2004-2008 Acura TL and TSX, 2003-2007 Honda Accord, 2005-2006 Honda CR-V, 2007-2011 Honda Element, 2005-2008 Honda Pilot and 2006-2014 Honda Ridgeline vehicles. The rotating portion of the accelerator pedal assembly may bind. As such, these vehicles fail to comply with the requirements of Federal Motor Vehicle Safety Standard (FMVSS) number 124, \"Accelerator Control Systems.\"",
"units": null,
"url": null,
"campaignNumber": "19E068000",
"manufacturer": "Dorman Products, Inc.",
"component": "VEHICLE SPEED CONTROL:ACCELERATOR PEDAL",
"summary": "Dorman Products, Inc. (Dorman) is recalling certain Accelerator Pedal Assemblies part numbers 699-114 and 825-5029-1, sold as replacement parts for 2003-2006 Acura MDX, 2004-2008 Acura TL and TSX, 2003-2007 Honda Accord, 2005-2006 Honda CR-V, 2007-2011 Honda Element, 2005-2008 Honda Pilot and 2006-2014 Honda Ridgeline vehicles. The rotating portion of the accelerator pedal assembly may bind. As such, these vehicles fail to comply with the requirements of Federal Motor Vehicle Safety Standard (FMVSS) number 124, \"Accelerator Control Systems.\"",
"consequence": "If the accelerator pedal binds, the engine may not quickly return to idle after the pedal is no longer pressed, increasing the risk of a crash.",
"notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236 (TTY 1-800-424-9153), or go to www.safercar.gov.",
"nhtsaActionNumber": null,
"parkIt": null,
"parkOutside": null,
"overTheAirUpdate": null
}
],
"nextCursor": null
}
},
"provider": "PrimaryAPI",
"credits": 1,
"items": 1,
"requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
"nextCursor": null
}Pricing and reliability
Calls go only to upstreams that are healthy right now. If an attempt fails, the call is retried automatically inside the same request; a failed attempt costs nothing, and a call never costs more than its quote’s maxCredits. Live figures below are measured on real traffic.
Success rate, uptime, latency and call counts are measured live from real traffic over 30 days and show “—” until there is data.
Errors
Errors are JSON { code, error, requestId } and are never charged. The ones to handle for this endpoint:
- invalid_inputThe request failed validation before anything ran.
- unauthorizedNo valid API key or session was presented.
- insufficient_balanceThe balance cannot cover the most this call could cost.
- key_limit_reachedThe key’s own spend limit is used up for the current window.
- trial_cap_reachedAn agent trial key has used its whole trial budget.
- forbiddenThe credential is valid but may not do this.
- not_foundThe thing addressed by the URL does not exist for you.
- idempotency_conflictThe
Idempotency-Keyis already bound to a different request. - rate_limitedToo many requests in the current window.
- all_sources_failedThe call could not be answered, even after automatic retries.
- service_unavailableThis API cannot run in this deployment right now.
- timeoutThe request passed its deadline before it finished.
Notes
Recalls are listed per vehicle model and year (NHTSA does not publish per-VIN repair status in this API). A VIN costs the same as make/model/year; one that cannot be decoded to a make, model and year is a free miss (reason vin_not_decoded). Rows use the same item shape as recalls.search (agency "nhtsa") plus NHTSA fields. Newest report first, ties by campaign number. A new campaign for the model changes the output, so a monitor on a VIN reports it.
Source: U.S. National Highway Traffic Safety Administration recalls (https://www.nhtsa.gov), US government public data. Recalls are listed per vehicle model and year, not per VIN: they do not say whether a specific vehicle has been repaired.
Generated from the PrimaryAPI catalog. Machine-readable contract: GET https://api.primaryapi.com/v1/apis/vin.recalls.