Cross-agency recall SUMMARY for a firm: counts by source + severity (lean dashboard) API

Joins CPSC + openFDA (food/device/drug) recalls for a firm and returns only the roll-up: total, counts by source, counts by severity class, an aggregate risk score, and the single worst recall headline — a cheap dashboard tile, no full list. Answers 'how many recalls and how bad for <firm>?', 'recall risk profile of <firm>'.

Price$0.01per request

MethodPOST

Route/v1/gov/recall-summary-by-firm

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

govrecallscpscfdafirmsummaryseveritycross-source

API URLhttps://x402.hexl.dev/v1/gov/recall-summary-by-firm

Integration docs

Example request

{
  "firm": "Tyson"
}

Example response

{
  "query": "Tyson",
  "totalRecalls": 7,
  "bySource": {
    "FDA": 7
  },
  "bySeverity": {
    "critical": 1,
    "high": 6,
    "moderate": 0,
    "low": 0,
    "unknown": 0
  },
  "aggregateRiskScore": 60,
  "aggregateRiskClass": "high",
  "worstRecall": {
    "source": "FDA",
    "title": "Vans gluten free Original 6 WAFFLES NET WT 9 OZ (255g) INGREDIENTS:***VAN'S GLUTEN FREE MIX (BROWN RICE FLOUR, POTATO STARCH, RICE FLOUR, SOY FLOUR),***RICE FLOUR,***SUNFLOWER AND/OR SOY LECITHIN***CO",
    "date": "2018-04-27",
    "severityClass": "critical",
    "severityScore": 90,
    "hazard": "The firm was notified that they failed to include the allergens milk & wheat in their ingredient statement.",
    "url": "https://www.accessdata.fda.gov/scripts/enforcement/enforce_rpt-Product-Tabs.cfm?action=select&recall_number=F-1475-2018"
  }
}

Input schema

{
  "type": "object",
  "required": [
    "firm"
  ],
  "properties": {
    "firm": {
      "type": "string",
      "description": "Firm/brand name, e.g. 'Tyson'."
    }
  }
}

Output schema

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