openFDA food recall enforcement by firm/state/classification/date, severity-mapped API

Queries openFDA FOOD enforcement reports by recalling firm, state, FDA classification (Class I/II/III) and/or date, normalized to a unified recall schema with Class->0-100 severity. Distinct from drug-by-name lookups. Answers 'what Class I food recalls happened?', 'has <firm> had a food recall?'.

Price$0.01per request

MethodPOST

Route/v1/gov/fda-food-recalls

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

govrecallsfdaopenfdafood-safetyenforcementseverity

API URLhttps://x402.hexl.dev/v1/gov/fda-food-recalls

Integration docs

Example request

{
  "classification": "Class I",
  "limit": 2
}

Example response

{
  "query": "Class I",
  "totalRecalls": 2,
  "bySource": {
    "FDA": 2
  },
  "bySeverity": {
    "critical": 2,
    "high": 0,
    "moderate": 0,
    "low": 0,
    "unknown": 0
  },
  "aggregateRiskScore": 90,
  "aggregateRiskClass": "critical",
  "worstRecall": {
    "source": "FDA",
    "recallId": "F-0609-2015",
    "date": "2014-10-10",
    "title": "Crema GuateLinda (Guatemalan Style Cream) in individually soft poly/plastic bags labeled in part: Lacteos Santa Martha Crema GuateLinda Guatemalan Style Cream Net WT 1 LB (16 oz)",
    "firm": "Oasis Brands, Inc",
    "productType": "food",
    "hazard": "Virginia State (VDACS) found Listeria monocytogenes in Lacteos Santa Martha Quesito Casero Fresh Curd (Best by 9/27/14), FDA made an inspection, were the environmental samples collected came up positive also for Listeria monocytogenes, also the Oasis Brands Inc. sent finish products samples to a private lab, the Lacteos Santa Martha Cuajada en Hoja Queso Casero Hecho a Mano Fresh Curd (Best By dates of 10/18/14 and 11/25/14) came also positive for Listeria monocytogenes.  Oasis Brands Inc.  is voluntarily recalling ALL their Lacteos Santa Martha brand products manufactured that are within expiration date.",
    "remedy": null,
    "units": "144 pieces",
    "status": "Terminated",
    "severityScore": 90,
    "severityClass": "critical",
    "url": "https://www.accessdata.fda.gov/scripts/enforcement/enforce_rpt-Product-Tabs.cfm?action=select&recall_number=F-0609-2015"
  },
  "totalMatching": 12743,
  "recalls": [
    {
      "source": "FDA",
      "recallId": "F-0609-2015",
      "date": "2014-10-10",
      "title": "Crema GuateLinda (Guatemalan Style Cream) in individually soft poly/plastic bags labeled in part: Lacteos Santa Martha Crema GuateLinda Guatemalan Style Cream Net WT 1 LB (16 oz)",
      "firm": "Oasis Brands, Inc",
      "productType": "food",
      "hazard": "Virginia State (VDACS) found Listeria monocytogenes in Lacteos Santa Martha Quesito Casero Fresh Curd (Best by 9/27/14), FDA made an inspection, were the environmental samples collected came up positive also for Listeria monocytogenes, also the Oasis Brands Inc. sent finish products samples to a private lab, the Lacteos Santa Martha Cuajada en Hoja Queso Casero Hecho a Mano Fresh Curd (Best By dates of 10/18/14 and 11/25/14) came also positive for Listeria monocytogenes.  Oasis Brands Inc.  is voluntarily recalling ALL their Lacteos Santa Martha brand products manufactured that are within expiration date.",
      "remedy": null,
      "units": "144 pieces",
      "status": "Terminated",
      "severityScore": 90,
      "severityClass": "critical",
      "url": "https://www.accessdata.fda.gov/scripts/enforcement/enforce_rpt-Product-Tabs.cfm?action=select&recall_number=F-0609-2015"
    },
    {
      "source": "FDA",
      "recallId": "F-1922-2012",
      "date": "2012-07-27",
      "title": "Yellow Onion.  Product is labeled in part:  \"***FC Salsa Mango\"***Refrigerate at 34 F***\"      Item #   302940 FC SALSA MANGO 2/5#.        Product is fresh made - Ready To Eat.",
      "firm": "FreshPoint South Florida",
      "productType": "food",
      "hazard": "FreshPoint South Florida is recalling sliced fresh yellow onions and salsa products processed using yellow onions sourced from Gills Onions, LLC which were recalled for Listeria monocytogenes.",
      "remedy": null,
      "units": "7 cases",
      "status": "Terminated",
      "severityScore": 90,
      "severityClass": "critical",
      "url": "https://www.accessdata.fda.gov/scripts/enforcement/enforce_rpt-Product-Tabs.cfm?action=select&recall_number=F-1922-2012"
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "firm": {
      "type": "string",
      "description": "Recalling firm name."
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state of the firm."
    },
    "classification": {
      "type": "string",
      "description": "'Class I', 'Class II', or 'Class III'."
    },
    "since": {
      "type": "string",
      "description": "Earliest report date, YYYY-MM-DD."
    },
    "limit": {
      "type": "number",
      "description": "Max recalls (1-50, default 20)."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}