{"uid":"cap_YT4rNelaqN7n4PGaHeb3z","slug":"fda-recall-search-api-699aba9a","name":"FDA Recall Search API","description":"Food, drug, and medical-device recall search: official US enforcement reports by category and product keyword — severity classification (Class I most serious), reason for recall, recalling firm, distribution area, and dates, newest first. Zero matches is a real answer, not an error. For food-safety, pharmacy, supplement, and commerce agents.","url":"https://x402.forgemesh.io/fda-recalls?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":25,"minimum":1},"query":{"type":"string","description":"product keyword, e.g. 'peanut' — empty returns newest in category"},"category":{"enum":["food","drug","device"],"type":"string","description":"recall category (default food)"}}},"responseSchema":{"type":"json","example":{"note":"classification: Class I = reasonable probability of serious harm; II = temporary/reversible harm; III = unlikely harm.","query":{"query":"peanut","category":"food"},"recalls":[{"reason":"Potential Salmonella contamination","status":"Ongoing","report_date":"20260810","distribution":"Nationwide","recall_number":"F-1234-2026","classification":"Class I","recalling_firm":"Example Foods LLC","recall_initiated":"20260801","product_description":"Example Peanut Butter 16oz jars"}],"returned":3,"attribution":"US FDA enforcement reports (public domain)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vfF34IdIFzTArNGmv7dLi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches official US FDA enforcement reports for food, drug, and medical device recalls by keyword and category, returning severity classification, reason, firm, and distribution details.","exampleAgentPrompt":"Can you check the FDA recalls database for any food recalls involving peanut butter — show me up to 10 results and tell me if any are Class I?","exampleUseCases":[{"title":"Food safety alert for a product","prompt":"I just saw a news story about contaminated peanut butter — can you pull up the latest FDA food recalls mentioning peanuts and tell me if there are any Class I recalls still ongoing?"},{"title":"Pharmacy compliance recall check","prompt":"Before we ship this order, can you check FDA drug recalls for 'metformin' and let me know if there are any active recalls, what the reason is, and how serious they are?"},{"title":"Medical device supplier audit","prompt":"We're auditing a supplier — can you search FDA device recalls for 'insulin pump' and return up to 25 results so I can see which firms have been recalled and the distribution areas affected?"}],"resultDescription":"A JSON object containing the original query parameters, a list of recall records (each with recall number, product description, recalling firm, classification, reason, status, distribution area, and recall/report dates), a count of returned records, and an attribution note. Zero results is a valid response meaning no matching recalls were found.","failureModes":["No matching recalls found (zero results) — valid response, not an error","Invalid category value outside food/drug/device enum — request rejected","Limit exceeds maximum of 25 — request rejected","Empty keyword with no category defaults to food category","Payment failure — x402 payment required before data is returned","Upstream FDA data temporarily unavailable — service error"],"whenToPreferThis":"Use this endpoint when you need structured, categorized FDA recall data with severity classifications directly from US enforcement reports. Prefer this over general web search when you need machine-readable recall records with fields like Class I/II/III, recall number, and distribution area. Ideal for food-safety agents, pharmacy compliance workflows, supplement vetting, and e-commerce product safety checks that need authoritative US recall status rather than news summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:49:02.217Z","isFirstParty":false,"canonicalSlug":"fda-recall-search-api-699aba9a"}