{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"recall.schema.json","title":"Product recall or safety alert (US FDA, US CPSC, US NHTSA, Health Canada, Transport Canada, CFIA, UK FSA, UK OPSS, EU Safety Gate, EU RASFF, France RappelConso, Netherlands NVWA, Australia FSANZ, New Zealand MBIE)","description":"Sources: openFDA enforcement reports and the openFDA medical device recall database (US FDA, CC0 1.0); US Consumer Product Safety Commission recalls (CPSC Recalls REST web services, US federal public information); US NHTSA recalls flat file (US government work, public domain); Health Canada Recalls and Safety Alerts (Open Government Licence - Canada); UK Food Standards Agency food alerts and UK Office for Product Safety and Standards product safety alerts on GOV.UK (Open Government Licence v3.0). European Commission Safety Gate weekly reports of alerts on dangerous non-food products (XML, CC0 1.0 on data.europa.eu) and European Commission RASFF food and feed notifications via the DG SANTE iRASFF API (CC BY 4.0 on data.europa.eu). Factual fields only. France RappelConso open data via the data.gouv.fr tabular API (Licence Ouverte 2.0); Netherlands NVWA safety warnings on nvwa.nl (CC0); Food Standards Australia New Zealand food recall alerts (CC BY 4.0); Product Safety New Zealand recalls by MBIE (CC BY 4.0).","type":"object","required":["id","country","authority","category","title","updated","url","allergens","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"FDA- plus the FDA recall number (for devices the same number in the enforcement reports and the device recall database), CPSC- plus the CPSC recall number, NHTSA- plus the NHTSA campaign number, HC- plus the Health Canada record number, the FSA alert notation (for example FSA-AA-48-2026) or OPSS- plus the OPSS reference; SG- plus the Safety Gate case number with slashes replaced by hyphens (for example SG-SR-02953-26); RASFF- plus the RASFF notification reference (for example RASFF-2026.9623); RC- plus the RappelConso sheet number (for example RC-2026-11-0048); NVWA- plus the publication date and page name; FSANZ- or NZ- plus the page name of the recall"},"country":{"enum":["US","CA","GB","EU","FR","NL","AU","NZ"],"description":"ISO 3166-1 alpha-2 code of the regulator's country (US, CA, GB, FR, NL, AU, NZ), or EU for European Commission systems (Safety Gate, RASFF)"},"authority":{"type":"string","description":"Regulator that published the recall or alert"},"category":{"enum":["food","feed","drug","medical-device","vehicle","consumer-product","health-product","cosmetic","other"],"description":"Normalised product category"},"product_category":{"type":["string","null"],"description":"Category as published by the regulator, for example Household items, SUV, Devices, Allergy alert, or NHTSA Vehicle, Equipment, Tire or Child restraint; Safety Gate product category (for example Toys) or RASFF product category (for example fruits and vegetables); RappelConso subcategory in French (for example jouets); NVWA voeding, levensmiddelen en diervoeders or consumentenartikelen; Product Safety New Zealand category"},"title":{"type":"string"},"product":{"type":["string","null"],"description":"Product description as published, capped at 300 characters"},"hazard":{"type":["string","null"],"description":"Reason for the recall or the risk statement; RASFF: hazards found, separated by semicolons; RappelConso reason for the recall in French; NVWA warning text in Dutch; FSANZ recall reason"},"allergens":{"type":"array","items":{"type":"string"},"description":"Allergens named in the alert (UK FSA allergy alerts; RASFF hazards in the allergens category); empty otherwise"},"classification":{"type":["string","null"],"description":"Recall class or risk level as published: FDA Class I to III (empty for device recalls not yet in an enforcement report), Health Canada Type I to III or Class 1 to 3, FSA alert type, OPSS risk level; Safety Gate risk level (Serious risk or Other risk levels); RASFF risk decision (serious, potentially serious, potential risk, not serious, no risk)"},"status":{"type":["string","null"],"description":"Recall status where published: FDA Ongoing, Completed or Terminated (enforcement reports) or Open, Classified, Completed or Terminated (device recall database); Health Canada Archived; FSA Published or Withdrawn; RASFF Validated or Withdrawn; RappelConso sheet version, for example Version 2"},"firm":{"type":["string","null"],"description":"Recalling firm, reporting business or vehicle manufacturer (companies only)"},"published":{"type":["string","null"],"format":"date","description":"Date the regulator published or reported the recall (ISO 8601); FDA device recall database: date the recall was posted"},"updated":{"type":"string","format":"date","description":"Date of the latest update by the regulator (ISO 8601)"},"url":{"type":"string","description":"Official page or API record of the recall; FDA: openFDA API record"},"recall_number":{"type":["string","null"],"description":"FDA recall number, CPSC recall number, NHTSA campaign number, Safety Gate case number or RASFF notification reference; RappelConso sheet number"},"event_id":{"type":["string","null"],"description":"FDA recall event ID (one event can cover several products); for devices the same event number in both FDA sources"},"initiated":{"type":["string","null"],"format":"date","description":"FDA: date the firm started the recall"},"voluntary_mandated":{"type":["string","null"],"description":"FDA: whether the recall was voluntary or ordered; RappelConso legal nature of the recall in French, for example volontaire (sans arrêté préfectoral)"},"distribution":{"type":["string","null"],"description":"FDA: distribution pattern (states or countries); RASFF: countries of distribution; capped at 200 characters; RappelConso sales area; FSANZ states and territories where the product was sold"},"lot_codes":{"type":["string","null"],"description":"FDA, Safety Gate, RappelConso and NVWA: lot, batch or code information, capped at 200 characters"},"firm_country":{"type":["string","null"],"description":"FDA: country of the recalling firm; CPSC: country or countries of manufacture"},"alert_type":{"type":["string","null"],"description":"OPSS: product safety alert, product safety report or product recall; Safety Gate: Consumer or Professional product; RASFF: notification classification, for example alert notification or border rejection notification"},"measures":{"type":"array","items":{"type":"string"},"description":"OPSS and Safety Gate: measures taken, for example withdrawal of product from market"},"component":{"type":["string","null"],"description":"NHTSA: vehicle component or components concerned, capped at 200 characters"},"units":{"type":["string","null"],"description":"CPSC, NHTSA and FDA device recalls: number of units affected as published, for example About 6,533 or 1024407"},"remedy_options":{"type":"array","items":{"type":"string"},"description":"CPSC and RappelConso: remedy offered, for example Refund, Replace or Repair, or remboursement"},"do_not_drive":{"type":["boolean","null"],"description":"NHTSA: true when NHTSA advises owners not to drive the vehicle until it is repaired"},"park_outside":{"type":["boolean","null"],"description":"NHTSA: true when NHTSA advises owners to park outside because of a fire risk"},"brand":{"type":["string","null"],"description":"Safety Gate, RappelConso and NVWA: product brand as published"},"model":{"type":["string","null"],"description":"Safety Gate and NVWA: type, model or article number, capped at 200 characters"},"barcode":{"type":["string","null"],"description":"Safety Gate, RappelConso, NVWA and Product Safety New Zealand: barcode (EAN, GTIN or UPC) as published, capped at 200 characters"},"risk_type":{"type":["string","null"],"description":"Safety Gate risk type (for example Chemical, Choking, Electric shock) or RASFF hazard category (for example pesticide residues, allergens); RappelConso risk in French (for example listeria monocytogenes); FSANZ recall reason (for example Undeclared allergen)"},"notifying_country":{"type":["string","null"],"description":"Safety Gate and RASFF: country whose authority notified the alert"},"origin_country":{"type":["string","null"],"description":"Safety Gate and RASFF: country or countries of origin of the product"},"notification_basis":{"type":["string","null"],"description":"RASFF: what triggered the notification, for example border control or official control on the market"},"product_code":{"type":["string","null"],"description":"FDA device recalls: three-letter FDA device product code, for example OZD"},"device_name":{"type":["string","null"],"description":"FDA device recalls: FDA device classification name of the product code"},"device_class":{"enum":["1","2","3",null],"description":"FDA device recalls: device class (1, 2 or 3) of the product code, not the recall class"},"medical_specialty":{"type":["string","null"],"description":"FDA device recalls: medical specialty panel of the product code, for example Cardiovascular"},"premarket_numbers":{"type":"array","items":{"type":"string"},"description":"FDA device recalls: 510(k) and PMA numbers of the recalled device"},"root_cause":{"type":["string","null"],"description":"FDA device recalls: root cause as categorised by FDA, for example Device Design or Under Investigation by firm"},"terminated":{"type":["string","null"],"format":"date","description":"FDA device recalls: date FDA terminated the recall; RappelConso: end date of the recall procedure"},"fda_page":{"type":["string","null"],"format":"uri","description":"FDA device recalls: official page in the FDA medical device recall database"},"merged_sources":{"type":"array","items":{"type":"string"},"description":"Other source IDs folded into this record, for example openfda-device-recall on an FDA device enforcement report"},"verification":{"const":"official-publication","description":"Copied from the regulator's own official publication"},"paid_placement":{"const":false,"description":"Always false: no record is paid for or promoted"},"source_id":{"enum":["openfda-enforcement","openfda-device-recall","health-canada-recalls","uk-fsa-food-alerts","uk-opss-product-safety","cpsc-recalls","nhtsa-recalls","eu-safety-gate","eu-rasff","fr-rappelconso","nl-nvwa-warnings","au-fsanz-food-recalls","nz-mbie-product-recalls"]},"source_url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}}}