> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhizomeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FDA FAERS

> Search filters and result fields of fda_faers.

* **Dataset id:** `fda_faers`
* **Jurisdiction:** US · FDA
* **Date field:** `receivedate`. The search's top-level `date_from` and `date_to` filter on it.
* **Access:** enterprise plan. Without it, search reports this dataset as `forbidden` and the document reader answers 403.

## Filters

Send these under `filters.fda_faers` in a [search](/api-reference/v3/search) request. A filter not listed here, or a value of the wrong type, is a 400. The top-level `date_from` and `date_to` set `date_from` and `date_to` below, so give a date in one place only.

<ParamField body="drug_names" type="string">
  Keyword match on drug names (BM25 tokenized). Example: 'ozempic semaglutide'.
</ParamField>

<ParamField body="reactions" type="string">
  Keyword match on adverse reactions (BM25 tokenized). Example: 'hepatotoxicity liver failure'.
</ParamField>

<ParamField body="reporter_country" type="string">
  Exact reporter country. Free-text with inconsistent forms — the same country appears as both a code and a full name (e.g. 'US' and 'UNITED STATES'). Exact match reproduces one stored form only; prefer keywords for country filtering.
</ParamField>

<ParamField body="serious" type="boolean">
  Seriousness flag (DB column is boolean). true = serious event, false = non-serious. FAERS source integer codes are also accepted: '1' (serious) / '2' (non-serious).
</ParamField>

<ParamField body="seriousnessdeath" type="boolean">
  Death flag (DB column is boolean). true = death reported, false = no death. FAERS source integer codes are also accepted: '1' (death) / '2' (no death).
</ParamField>

<ParamField body="quarter" type="string">
  Reporting quarter, lowercase 'q' (e.g. '2024q1'). Input case is normalized, so '2024Q1' also matches.
</ParamField>

<ParamField body="date_from" type="string (date)">
  Inclusive lower bound on receive date (YYYY-MM-DD).
</ParamField>

<ParamField body="date_to" type="string (date)">
  Inclusive upper bound on receive date (YYYY-MM-DD).
</ParamField>

## Fields

Each result from this dataset has these in `fields`:

`drug_names`, `quarter`, `reactions`, `receivedate`, `reporter_country`, `safetyreportid`, `serious`, `seriousnessdeath`, `url`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.