Fda Drug Events
fda_drug_eventsRead-onlyIdempotent
Search FAERS adverse event reports by drug name, MedDRA reaction term, or date range. Returns report counts, reaction types, seriousness levels, and dates. Natural multi-word reaction phrasing is retried against MedDRA preferred-term word order before an empty result is reported. FAERS reports do not establish incidence or causality.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Offset for pagination (default 0) | |
| limit | No | Number of results (1-100, default 10) | |
| query | Yes | OpenFDA search query. FAERS stores a drug under FOUR different fields and no single one is complete: patient.drug.openfda.generic_name / .brand_name / .substance_name are enrichment (missing for some newer or compounded drugs, but when present they fold every brand variant under the ingredient), and patient.drug.medicinalproduct is the reporter's own free-text drug name (always present, but literal — a generic-name filter there misses every report filed under a brand). A query that names exactly ONE of these four fields for a drug is automatically expanded to an OR across all four with the same value, so you get every report regardless of which field openFDA happened to index it under — the response names which fields were searched in drug_name_fields_searched. Write whichever single field is natural; do not hand-write the OR yourself. Examples: 'patient.drug.medicinalproduct:"OZEMPIC"', 'patient.drug.openfda.generic_name:"semaglutide"+AND+serious:1', 'receivedate:[20240101+TO+20241231]' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | Yes | Offset used in pagination | |
| limit | Yes | Number of results returned | |
| total | Yes | Total count of matching adverse event reports | |
| results | Yes | Array of adverse event report objects | |
| reaction_resolved | No | The MedDRA preferred term actually used for the filter | |
| reaction_requested | No | The reaction term as the caller supplied it, uppercased | |
| reaction_resolution | No | How the supplied reaction term mapped onto a MedDRA preferred term. not_a_meddra_preferred_term means the filter matched nothing — counts are zero because the term missed, not because no reports exist | |
| reaction_resolution_hint | No | Present when the term matched nothing; names a working way to discover the real preferred terms | |
| reaction_resolution_note | No | Present when word order was corrected; states the substitution made |