{"uid":"cap_YQUuPsRtLlG_fhQ2n2wSL","slug":"fda-drug-recalls-fa2a6598","name":"FDA Drug Recalls","description":"FDA drug recall lookup — enforcement reports naming a drug, newest first, with recall class and its meaning, status, reason, product description, recalling firm, dates, distribution and quantity. Use to check whether a drug or lot has been recalled and why.","url":"https://fda-drugs.use.x402atlas.com/recalls?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["drug"],"properties":{"drug":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9 .,'()/-]{0,99}$","description":"Brand or generic name, or text from the product description; omitted runs the example"},"limit":{"type":"integer","default":10,"maximum":50,"minimum":1},"status":{"enum":["all","ongoing","completed","terminated"],"type":"string","default":"all"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","source","caveat","modified","drug","status","count","total","recalls"],"properties":{"drug":{"type":"string","description":"Name as searched"},"note":{"type":"string","description":"Present only when nothing matched"},"as_of":{"type":"string","format":"date-time","description":"Retrieval time, UTC"},"count":{"type":"integer","description":"Reports returned"},"total":{"type":"integer","description":"Reports matching"},"caveat":{"type":"string","description":"Fixed interpretation note"},"source":{"type":"object","required":["name","url","citation"],"properties":{"url":{"type":"string"},"name":{"type":"string"},"citation":{"type":"string","description":"Credit line FDA asks for"}},"additionalProperties":false},"status":{"enum":["all","ongoing","completed","terminated"],"type":"string","description":"Applied filter"},"recalls":{"type":"array","items":{"type":"object","required":["recall_number","classification","classification_meaning","status","reason","product_description","brand_names","generic_names","recalling_firm","initiated","reported","distribution","quantity","voluntary_mandated","location","event_id"],"properties":{"reason":{"type":"string"},"status":{"type":"string","description":"ongoing, completed or terminated"},"event_id":{"type":"string","description":"Groups recalls from one event"},"location":{"type":"string","description":"Recalling firm's city, state, country"},"quantity":{"type":"string"},"reported":{"type":"string","description":"YYYY-MM-DD the enforcement report was published"},"initiated":{"type":"string","description":"YYYY-MM-DD"},"terminated":{"type":"string","description":"YYYY-MM-DD; absent while the recall is open"},"brand_names":{"type":"array","items":{"type":"string"},"description":"Empty when FDA did not harmonize the product"},"distribution":{"type":"string"},"generic_names":{"type":"array","items":{"type":"string"},"description":"Empty when FDA did not harmonize the product"},"recall_number":{"type":"string"},"classification":{"type":"string","description":"Class I, Class II or Class III"},"recalling_firm":{"type":"string"},"voluntary_mandated":{"type":"string"},"product_description":{"type":"string"},"classification_meaning":{"type":"string","description":"FDA's definition of the class"}},"additionalProperties":false},"description":"Newest initiation first"},"modified":{"type":"boolean","description":"Always true: fields are normalized, not the agency's verbatim record"}},"additionalProperties":false}}}}},"responseSchema":null,"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_RMtJlYv7c3pJpckJnjOLi","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":"Looks up FDA drug recall enforcement reports for a given drug name, returning recall class, status, reason, recalling firm, distribution, and quantity — newest first.","exampleAgentPrompt":"Can you check if there are any FDA recalls for metformin — I want to see the most recent ones, including the recall class, reason, and whether they're still ongoing?","exampleUseCases":[{"title":"Patient safety medication check","prompt":"I just picked up my prescription for losartan — can you pull up any FDA recall reports for it so I can see if my lot might be affected and what the reason was?"},{"title":"Pharmacy compliance audit","prompt":"We need to audit our stock — can you look up all FDA enforcement recalls for ranitidine, show me up to 20 results including recall class, recalling firm, distribution area, and current status?"},{"title":"Journalist drug safety investigation","prompt":"I'm writing a story on opioid recalls — can you find the latest FDA recall reports for oxycodone, including why each was recalled, who initiated it, and whether they're completed or still ongoing?"}],"resultDescription":"Returns a JSON object with the searched drug name, retrieval timestamp, FDA source citation, total matching reports, count returned, and an array of recall records. Each record includes recall number, Class I/II/III classification with plain-English meaning, status (ongoing/completed/terminated), reason for recall, full product description, brand and generic names, recalling firm name and location, initiation and reported dates, distribution scope, quantity recalled, and whether the recall was voluntary or mandated.","failureModes":["Drug name not found in FDA enforcement database — returns count:0 with a note field","Invalid drug name format (fails regex) — returns 400 validation error","Drug name too long (over 100 characters) — rejected by schema validation","Limit out of range (below 1 or above 50) — schema validation error","Invalid status enum value — rejected with validation error","FDA upstream API unavailable — may return 502 or timeout","No recalls match the combined drug + status filter — returns empty recalls array"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured FDA enforcement recall data for a specific drug — including recall class, reason, recalling firm, and distribution scope. Prefer this over general web search when you need machine-readable recall records with official FDA sourcing for compliance, safety verification, or audit workflows. Choose this over the sibling FDA Drug Label endpoint when the question is about past or active recalls rather than prescribing information.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:43:39.260Z","isFirstParty":false,"canonicalSlug":"fda-drug-recalls-fa2a6598"}