Look 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.
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"
}