Cette documentation est retirée vers docs.carsxe.com. Ce site sera mis hors service le 1er octobre 2026.
Aller vers la nouvelle documentationLook up safety recalls by year, make, and model — no VIN needed.
The Recalls by YMM API provides structured safety recall data by year, make, and model — no VIN required. This is ideal for developers who need to check recalls for an entire model line, populate fleet dashboards, or enrich vehicle listings without individual VINs.
This endpoint allows you to retrieve safety recall data for any vehicle using its year, make, and model.
keyYour CarsXE API key.
yearThe 4-digit model year of the vehicle (e.g. 2019). Must be between 1900 and the current model year plus one.
makeThe vehicle manufacturer name (e.g. Toyota). Case-insensitive — the API normalises to uppercase internally.
modelThe vehicle model name (e.g. Camry). Case-insensitive — the API normalises to uppercase internally.
successWhether the request was processed successfully.
inputThe normalised input values echoed back: year, make (uppercase), model (uppercase).
dataThe recall result object for the requested vehicle.
makeThe vehicle manufacturer name, normalised to uppercase.
modelThe vehicle model name, normalised to uppercase.
model_yearThe 4-digit model year of the vehicle.
recall_countThe total number of recalls found for this year, make, and model combination.
has_recallstrue when recall_count is greater than zero; false otherwise.
recallsAn array of recall objects. Empty array when there are no recalls.
nhtsa_campaign_numberThe NHTSA campaign number uniquely identifying this recall (e.g. 19V312000).
manufacturerThe full legal name of the manufacturer issuing the recall.
park_ittrue if NHTSA advises parking the vehicle until the remedy is completed.
park_outsidetrue if NHTSA advises parking the vehicle outside and away from structures until the remedy is completed.
over_the_air_updatetrue if the remedy can be delivered via an over-the-air software update.
report_received_dateThe date NHTSA received the recall report, in MM/DD/YYYY format.
componentThe vehicle component or system affected by the recall (e.g. ELECTRICAL SYSTEM).
summaryA detailed description of the defect or non-compliance that prompted the recall.
consequenceThe safety risk to vehicle occupants or others if the defect is not corrected.
remedyThe corrective action the manufacturer will take, including whether it is free of charge.
notesAdditional notes from the manufacturer or NHTSA, such as owner notification timelines.
timestampISO 8601 timestamp of the API response.
The Recalls by YMM API lets you retrieve safety recall data for any vehicle by providing its year, make, and model — no VIN required. It returns recall counts, affected components, summaries, consequences, and remedies in a structured JSON response.
The VIN-based Recalls API targets a single specific vehicle using its 17-character VIN. The YMM API looks up recalls for an entire make, model, and year combination — useful when you don't have individual VINs or want to check an entire model line at once.
CarsXE aggregates safety recall data from authoritative government databases, normalizes it into structured JSON, and serves it through a cached, high-availability API — so you don't have to build or maintain the integration yourself.
has_recalls is a boolean that is true when recall_count is greater than zero, indicating NHTSA has at least one recall on file for the given year, make, and model.
CarsXE fetches fresh data for each unique year/make/model combination and caches responses for 24 hours. New recalls are typically reflected within one day of being issued.
Yes, it requires a CarsXE API key passed as the key query parameter.
The API returns a successful response with recall_count: 0, has_recalls: false, and an empty recalls array. A 400 from NHTSA is treated as no recalls found, not an error.
Yes! The Recalls by YMM API is included in the free Sandbox as part of the shared lifetime quota (up to 100 API calls). For more information visit our pricing page.
curl -G https://api.carsxe.com/v1/recalls-ymm \
-d key=CARSXE_API_KEY \
-d year=2026 \
-d make=toyota \
-d model=corolla{
"success": true,
"input": {
"year": "2026",
"make": "TOYOTA",
"model": "COROLLA"
},
"data": {
"make": "TOYOTA",
"model": "COROLLA",
"model_year": "2026",
"recall_count": 1,
"has_recalls": true,
"recalls": [
{
"nhtsa_campaign_number": "26V110000",
"manufacturer": "Toyota Motor Engineering & Manufacturing",
"park_it": false,
"park_outside": false,
"over_the_air_update": false,
"report_received_date": "25/02/2026",
"component": "EXTERIOR LIGHTING:HEADLIGHTS",
"summary": "Toyota Motor Engineering & Manufacturing (Toyota) is recalling certain 2026 Corolla vehicles. The front headlights may have missing headlight aim markings, which can result in improperly aimed headlights during service. As such, these vehicles fail to comply with the requirements of Federal Motor Vehicle Safety Standard number 108, \"Lamps, Reflective Devices, and Associated Equipment.\"",
"consequence": "Incorrectly aimed headlights can reduce driver visibility or create a glare for oncoming traffic, increasing the risk of a crash.",
"remedy": "Dealers will replace both front headlight assemblies, free of charge. Owner notification letters were mailed April 20, 2026. Owners may contact Toyota's customer service at 1-800-331-4331. Toyota's number for this recall is 26TA05.",
"notes": null
}
]
},
"timestamp": "2026-06-29T12:00:45.786Z"
}