Esta documentação está sendo aposentada para docs.carsxe.com. Este site será descomissionado em 1º de outubro de 2026.
Ir para a nova documentaçãoRetrieve Vehicle Recall information using a VIN.
The Vehicle Recalls API provides access to recall data by allowing users to search for safety recalls based on a vehicle's VIN. This API is useful for developers who need to access recall information for a specific vehicle.
This endpoint allows you to retrieve vehicle recall information using a VIN.
keyYour CarsXE API key.
vinThe 17 character long vehicle identification number.
successWhether the vehicle data has been retrieved successfully.
queryObject detailing the query you made, including the API key and VIN.
dataObject containing vehicle details, recall information, and related metadata.
uuidUnique identifier for the vehicle record.
vinThe Vehicle Identification Number (VIN) of the queried vehicle.
manufacturerThe name of the vehicle manufacturer.
model_yearThe model year of the vehicle.
makeThe make (brand) of the vehicle.
modelThe model name of the vehicle.
has_recallsIndicates whether there are any recalls associated with the vehicle.
recall_countNumber of recalls associated with the vehicle.
recallsA list of recall objects, each containing detailed recall information.
recall_dateThe date the recall was issued.
expiration_dateThe expiration date of the recall, if applicable.
nhtsa_idThe recall ID assigned by NHTSA (National Highway Traffic Safety Administration).
manufacturer_idThe recall ID assigned by the manufacturer.
recall_campaign_typeThe type of recall campaign (e.g., NHTSA, manufacturer-initiated).
recall_nameThe name or title of the recall campaign.
componentThe vehicle component affected by the recall.
recall_descriptionA short description of the recall.
risk_descriptionA detailed explanation of the risks associated with the recall.
stop_saleIndicates whether the recall includes a stop-sale order.
dont_driveIndicates whether the recall includes a "do not drive" advisory.
remedy_availableIndicates whether a remedy for the recall is available.
recall_remedyDescription of the manufacturer’s remedy for the recall.
parts_availableIndicates whether the necessary parts for the recall remedy are available.
labor_hours_minMinimum estimated labor hours for the recall repair.
labor_hours_maxMaximum estimated labor hours for the recall repair.
recall_statusThe current status of the recall (e.g., Incomplete, Completed).
timestampThe timestamp of the API response.
The Vehicle Recalls API allows users to retrieve safety recall data based on VIN, providing detailed recall information, remedies, and status.
The Vehicle Recalls API works by allowing users to query recall data using a vehicle's VIN. The API returns detailed recall information, including recall date, description, risks, and remedy.
The API provides recall ID, affected components, description, remedy details, recall status, issue and remedy dates, and manufacturer information.
Yes, using a VIN lookup, you can retrieve past and current recalls issued for a particular vehicle.
Yes, it indicates whether a recall is completed (fixed) or incomplete (unfixed).
Yes, recall API can be integrated into websites, dealership management systems, and fleet management platforms.
Yes, it requires an API key for authentication and access.
Yes! The Vehicle Recalls 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 \
-d key=CARSXE_API_KEY \
-d vin=1C4JJXR64PW696340{
"success": true,
"input": {
"key": "API_KEY",
"vin": "1C4JJXR64PW696340"
},
"data": {
"uuid": "d1269d6b-54a2-4bf3-8119-1c8fdb4f0563",
"vin": "1C4JJXR64PW696340",
"manufacturer": "FCA US LLC",
"model_year": "2023",
"make": "JEEP",
"model": "Wrangler",
"has_recalls": true,
"recall_count": 1,
"recalls": [
{
"recall_date": "2024-09-27",
"expiration_date": null,
"nhtsa_id": "24V720",
"manufacturer_id": "95B",
"recall_campaign_type": "NHTSA",
"recall_name": "2020-2024 JL & 2022-2024 WL PHEV High Voltage Battery",
"component": "",
"recall_description": "2020-2024 JL & 2022-2024 WL PHEV High Voltage Battery",
"risk_description": "In rare circumstances, a battery pack may contain cells with separator damage. Separator damage, combined with other complex interactions within the cells, may lead to a vehicle fire. A vehicle fire can result in increased risk of occupant injury and/or injury to persons outside the vehicle, as well as property damage.",
"stop_sale": null,
"dont_drive": null,
"remedy_available": null,
"recall_remedy": "FCA US will conduct a voluntary safety recall on all affected vehicles. Remedy is a software flash followed by a HV battery replacement if needed.",
"parts_available": null,
"labor_hours_min": null,
"labor_hours_max": null,
"recall_status": "Incomplete"
}
]
},
"timestamp": "2025-10-03T08:46:03.701Z"
}