Recall
v0.1.0A manufacturer safety recall (typically an NHTSA campaign, plus its OEM-internal counterpart) affecting a specific vehicle in the dealer's operational context. Captures the campaign identity (nhtsa_campaign_number / oem_recall_number), the affected vehicle and its decoded make/model/year/VIN, the regulatory narrative (component, summary, consequence, remedy) as published by the manufacturer under 49 CFR Part 573, the risk classification, parts and remedy availability, owner-notification milestones, the stop-sale / do-not-drive posture, and the local completion workflow (scheduled/completed timestamps and the service order that performed the fix) including the warranty labor operation claimed. One Recall record represents one campaign as it applies to one vehicle; a vehicle with three open campaigns yields three Recall records. Lineage: campaign narrative and milestone fields map to NHTSA's Recalls API (api.nhtsa.gov recallsByVehicle / SafercarRecallsByVehicle endpoints) and OEM warranty/recall feeds (e.g. Ford OASIS, GM GWM/VIS, Toyota TIS); the vehicle linkage and remedy workflow extend ADF/AutomotiveAPI service intents into a typed record a DMS or CRM can act on.
service.get_recallservice.list_recalls{
"id": "6f9c2a10-4b7e-4d2f-9a1e-2c3b4d5e6f70",
"source_ids": [
{
"system": "cdk_drive",
"id": "RCL-2024-000812",
"sequence": 1
},
{
"system": "ford_oasis",
"id": "23S45-1FTFW1E85NFA00001",
"sequence": 2
}
],
"nhtsa_campaign_number": "23V456000",
"oem_recall_number": "23S45",
"recall_type": "vehicle",
"manufacturer": "Ford Motor Company",
"campaign_url": "https://www.nhtsa.gov/recalls?nhtsaId=23V456000",
"vehicle_id": "b1e2c3d4-5f60-4a7b-8c9d-0e1f2a3b4c5d",
"vin": "1FTFW1E85NFA00001",
"make": "Ford",
"model": "F-150",
"year": 2022,
"component": "ELECTRICAL SYSTEM:WIRING:FRONT UNDERHOOD",
"summary": "Certain 2022 F-150 vehicles may have an improperly crimped front underhood wiring harness connector that can corrode and lose electrical contact over time.",
"consequence": "Loss of electrical contact can disable the low-beam headlamps without warning, reducing forward visibility at night and increasing the risk of a crash.",
"remedy": "Dealers will inspect the front underhood wiring harness connector and replace it as necessary, free of charge. Interim and final owner notification letters were mailed.",
"remedy_type": "inspect",
"risk": "safety",
"status": "scheduled",
"do_not_drive": false,
"stop_sale": false,
"reported_date": "2023-08-14",
"owner_notified_date": "2023-09-25",
"remedy_available": true,
"remedy_available_date": "2023-11-01",
"labor_operation_code": "23S45B",
"labor_time_hours": 0.7,
"affected_vehicles_estimate": 142000,
"scheduled_at": "2026-07-08T14:30:00Z",
"service_order_id": "9a8b7c6d-5e4f-4321-9876-1a2b3c4d5e6f",
"warranty_claim_number": "W-2026-0099812",
"repair_facility": {
"name": "Metro Ford Service",
"dealer_code": "F12345",
"address": {
"city": "Detroit",
"region": "MI",
"postal_code": "48226",
"country": "US",
"lines": [
"100 Woodward Ave"
]
}
},
"source_last_synced_at": "2026-06-28T06:00:00Z",
"notes": "Owner contacted 2026-06-25; scheduled for 07-08. Loaner reserved due to headlamp concern.",
"created_at": "2023-08-20T09:15:00Z",
"updated_at": "2026-06-28T17:42:11Z",
"extensions": {
"com.exampledealer.priority": "high",
"com.exampledealer.do_not_drive": false,
"gov.nhtsa.remedy_component_id": 991234
}
}