ToolMint openFDA Recalls

Routes and prices

Free routes: /, /health, /openapi.json, /.well-known/x402.

Try it

Copycurl -i "https://toolmint-openfda-recalls-json.toolmint.workers.dev/recalls?productType=drug&status=Ongoing&limit=10"

When to use it

• Check whether a product or company has FDA recall enforcement reports.
• List the latest ongoing Class I (most serious) recalls in food, drugs or devices.
• Get the class explained in plain words (classificationGuide).

Not for: adverse events (a different openFDA endpoint set, not covered), per-lot safety checks, or medical advice.

Example

curl -i "https://toolmint-openfda-recalls-json.toolmint.workers.dev/recalls?productType=drug&classification=Class%20I&status=Ongoing&limit=5"

That hostname is the planned Worker name. The tool is not deployed yet.

Trimmed response (values illustrative):

{
  "tool": "openfda-recalls-json",
  "version": "0.1.0",
  "count": 5,
  "byClassification": { "Class I": 5 },
  "classificationGuide": {
    "Class I": "Class I - most serious: reasonable probability of serious adverse health consequences or death.",
    "Class II": "...", "Class III": "..."
  },
  "recalls": [
    {
      "recallNumber": "...", "eventId": "...", "productType": "Drugs",
      "classification": "Class I",
      "classificationExplained": "Class I - most serious: ...",
      "status": "Ongoing", "recallingFirm": "...",
      "productDescription": "...", "reasonForRecall": "...",
      "codeInfo": "...", "distributionPattern": "...", "voluntaryMandated": "...",
      "recallInitiationDate": "20260101", "reportDate": "20260110",
      "city": "...", "state": "...", "country": "..."
    }
  ],
  "summary": { "headline": "5 recall(s): 5 Class I, 0 Class II, 0 Class III." },
  "query": { "productType": "drug", "classification": "Class I", "status": "Ongoing", "search": "...", "limit": 5, "skip": 0 },
  "provenance": {
    "source": "openFDA", "sourceUrl": "https://api.fda.gov/drug/enforcement.json?search=...",
    "sourceUrls": ["..."], "fetchedAt": "2026-10-31T12:00:00.000Z",
    "license": "CC0 1.0 Universal (US government work / public domain dedication)",
    "licenseUrl": "https://open.fda.gov/license/", "termsUrl": "https://open.fda.gov/terms/"
  },
  "fetchedAt": "2026-10-31T12:00:00.000Z",
  "disclaimer": "Do not rely on openFDA to make decisions regarding medical care. Results are unvalidated. Not for clinical use.",
  "clinicalUse": false,
  "cached": false
}

Results are de-duplicated and sorted Class I, then II, then III, then newest report date.

Data source and licence

openFDA enforcement endpoints (api.fda.gov/food|drug|device/enforcement.json). CC0 1.0 (public domain dedication); see https://open.fda.gov/terms/. This is not an official FDA product.

Freshness and caching

Full results may be cached in memory for 15 minutes (cached: true). Partial results and errors are not cached. openFDA itself updates its enforcement data on its own schedule; fetchedAt shows when we asked.

Limits

• Max 50 results per call, skip up to 500.
• Search is a phrase/term match on product description and firm name, not fuzzy.
• Long text is cut (product description and reason 1200 chars).

Errors are not charged

Payment settles only on a successful answer. These responses are never settled: