{"uid":"cap_FDWSemFPMFyQ-MwESno5X","slug":"fda-adverse-event-counts-5a38b57f","name":"FDA Adverse Event Counts","description":"FDA adverse event counts — FAERS reports naming a drug: total reports, how many were serious, and the most reported reactions with counts and shares. Report counts are not incidence and prove no causation; use for pharmacovigilance signals and safety research, not clinical decisions.","url":"https://fda-drugs.use.x402atlas.com/adverse-events?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; omitted runs the example"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Reaction terms to return"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","source","caveat","modified","drug","total_reports","serious_reports","serious_share","reactions","data_through"],"properties":{"drug":{"type":"string","description":"Name as searched"},"note":{"type":"string","description":"Present only when no report names the drug"},"as_of":{"type":"string","format":"date-time","description":"Retrieval time, UTC"},"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},"modified":{"type":"boolean","description":"Always true: fields are normalized, not the agency's verbatim record"},"reactions":{"type":"array","items":{"type":"object","required":["term","count","share"],"properties":{"term":{"type":"string","description":"MedDRA preferred term, lowercase"},"count":{"type":"integer","description":"Reports naming the reaction"},"share":{"type":"number","description":"count / total_reports, 3 decimals"}},"additionalProperties":false},"description":"Most reported first"},"data_through":{"type":"string","description":"YYYY-MM-DD of the FAERS extract; reports lag three months or more"},"serious_share":{"type":"number","description":"serious_reports / total_reports, 3 decimals"},"total_reports":{"type":"integer","description":"FAERS reports naming the drug"},"serious_reports":{"type":"integer","description":"Reports flagged serious"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vztx6qx9-MVTSqOXHUKM4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns FAERS adverse event report counts for a drug, including total reports, serious report counts, and the most frequently reported reactions with their shares.","exampleAgentPrompt":"Pull the FDA adverse event counts for metformin from FAERS — I want to see the total reports, how many were serious, and the top 20 most reported reactions with their counts and shares.","exampleUseCases":[{"title":"Drug safety signal screening","prompt":"Can you look up the FDA adverse event data for semaglutide and show me how many total reports there are, how many were serious, and what the top 15 most common reactions are?"},{"title":"Comparing serious event rates","prompt":"I'm doing a pharmacovigilance review — pull FAERS adverse event counts for warfarin, including the serious report share and the top 30 reactions, so I can assess the safety signal profile."},{"title":"Patient safety research briefing","prompt":"For my drug safety research, get the FDA FAERS adverse event counts for Humira — total reports, serious reports, and the most frequently reported reactions ranked by count."}],"resultDescription":"A JSON object containing the drug name as searched, retrieval timestamp, FAERS data-through date, total report count, serious report count, serious share (ratio), a fixed caveat note about interpretation, source attribution, and an array of the most-reported reactions ranked by frequency — each with MedDRA preferred term, report count, and share of total reports.","failureModes":["Drug name not found in FAERS returns a response with a note field and zero/empty counts","Invalid drug name format (violating pattern) returns a validation error","Limit parameter out of range (below 1 or above 100) returns a validation error","FAERS data temporarily unavailable returns a service error","Misspelled drug name may return no data or data for a different substance"],"whenToPreferThis":"Use this endpoint when you need quantitative pharmacovigilance signals from the FDA's FAERS database — specifically report counts, serious event rates, and ranked reaction profiles for a named drug. Prefer it over FDA label lookups when you need post-market safety signal data rather than prescribing information, and over recall endpoints when you need reaction frequency data rather than enforcement actions. Best suited for drug safety research, regulatory monitoring, and pharmacovigilance workflows — not for clinical decision support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:38:17.756Z","isFirstParty":false,"canonicalSlug":"fda-adverse-event-counts-5a38b57f"}