Fda Drug Adverse Event Detail Tools#

Configuration File: fda_drug_adverse_event_detail_tools.json Tool Type: Local Tools Count: 6

This page contains all tools defined in the fda_drug_adverse_event_detail_tools.json configuration file.

Available Tools#

FAERS_search_adverse_event_reports (Type: FDADrugAdverseEventDetailTool)#

Search and retrieve detailed adverse event reports from FAERS. Returns individual case reports wi…

FAERS_search_adverse_event_reports tool specification

Tool Information:

  • Name: FAERS_search_adverse_event_reports

  • Type: FDADrugAdverseEventDetailTool

  • Description: Search and retrieve detailed adverse event reports from FAERS. Returns individual case reports with patient information, adverse event details, drug information, and report metadata. Only medicinalproduct is required; all other parameters (limit, skip, patientsex, patientagegroup, occurcountry, serious, seriousnessdeath) are optional. Use filters sparingly to avoid overly restrictive searches. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproduct (string) (required) Drug name (required).

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • occurcountry (string) (optional) Optional: Filter by country where event occurred (ISO2 code, e.g., ‘US’, ‘GB’). Omit this parameter if you don’t want to filter by country.

  • serious (string) (optional) Optional: Filter by event seriousness. Omit this parameter if you don’t want to filter by seriousness.

  • seriousnessdeath (string) (optional) Optional: Pass ‘Yes’ to filter for reports where death was an outcome. Omit this parameter to include all reports regardless of death outcome.

Example Usage:

query = {
    "name": "FAERS_search_adverse_event_reports",
    "arguments": {
        "medicinalproduct": "example_value"
    }
}
result = tu.run(query)

FAERS_search_reports_by_drug_and_indication (Type: FDADrugAdverseEventDetailTool)#

Search and retrieve detailed adverse event reports for a specific drug and indication. Returns in…

FAERS_search_reports_by_drug_and_indication tool specification

Tool Information:

  • Name: FAERS_search_reports_by_drug_and_indication

  • Type: FDADrugAdverseEventDetailTool

  • Description: Search and retrieve detailed adverse event reports for a specific drug and indication. Returns individual case reports with patient information, adverse event details, drug information, and report metadata. Only medicinalproduct is required; all other parameters (drugindication, limit, skip, patientsex, patientagegroup, serious) are optional. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproduct (string) (required) Drug name (required).

  • drugindication (string) (optional) Optional: Filter by drug indication (e.g., ‘Dementia Alzheimer's type’, ‘Alzheimer disease’). Omit this parameter if you don’t want to filter by indication.

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • serious (string) (optional) Optional: Filter by event seriousness. Omit this parameter if you don’t want to filter by seriousness.

Example Usage:

query = {
    "name": "FAERS_search_reports_by_drug_and_indication",
    "arguments": {
        "medicinalproduct": "example_value"
    }
}
result = tu.run(query)

FAERS_search_reports_by_drug_and_outcome (Type: FDADrugAdverseEventDetailTool)#

Search and retrieve detailed adverse event reports for a specific drug filtered by reaction outco…

FAERS_search_reports_by_drug_and_outcome tool specification

Tool Information:

  • Name: FAERS_search_reports_by_drug_and_outcome

  • Type: FDADrugAdverseEventDetailTool

  • Description: Search and retrieve detailed adverse event reports for a specific drug filtered by reaction outcome. Returns individual case reports with patient information, adverse event details, drug information, and report metadata. Only medicinalproduct is required; all other parameters (reactionoutcome, limit, skip, patientsex, patientagegroup, serious) are optional. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproduct (string) (required) Drug name (required).

  • reactionoutcome (string) (optional) Optional: Filter by reaction outcome. Omit this parameter if you don’t want to filter by outcome.

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • serious (string) (optional) Optional: Filter by event seriousness. Omit this parameter if you don’t want to filter by seriousness.

Example Usage:

query = {
    "name": "FAERS_search_reports_by_drug_and_outcome",
    "arguments": {
        "medicinalproduct": "example_value"
    }
}
result = tu.run(query)

FAERS_search_reports_by_drug_and_reaction (Type: FDADrugAdverseEventDetailTool)#

Search and retrieve detailed adverse event reports for a specific drug and reaction type. Returns…

FAERS_search_reports_by_drug_and_reaction tool specification

Tool Information:

  • Name: FAERS_search_reports_by_drug_and_reaction

  • Type: FDADrugAdverseEventDetailTool

  • Description: Search and retrieve detailed adverse event reports for a specific drug and reaction type. Returns individual case reports with patient information, adverse event details, drug information, and report metadata. Only medicinalproduct and reactionmeddrapt are required; all other parameters (limit, skip, patientsex, patientagegroup, serious) are optional. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproduct (string) (required) Drug name (required).

  • reactionmeddrapt (string) (required) MedDRA preferred term for the adverse reaction (required). Example: ‘INFUSION RELATED REACTION’, ‘DYSPNOEA’. Must be the exact MedDRA Preferred Term FAERS uses, not a clinical description or synonym – e.g. ‘NEPHROTOXICITY’ matches nothing, the real terms are ‘ACUTE KIDNEY INJURY’ or ‘RENAL IMPAIRMENT’. A non-matching term returns an empty result (not an error), which looks identical to a genuine zero-report finding. If unsure of the exact term, call FAERS_count_reactions_by_drug_event first (with just medicinalproduct) to list the actual MedDRA terms reported for that drug.

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • serious (string) (optional) Optional: Filter by event seriousness. Omit this parameter if you don’t want to filter by seriousness.

Example Usage:

query = {
    "name": "FAERS_search_reports_by_drug_and_reaction",
    "arguments": {
        "medicinalproduct": "example_value",
        "reactionmeddrapt": "example_value"
    }
}
result = tu.run(query)

FAERS_search_reports_by_drug_combination (Type: FDADrugInteractionDetailTool)#

Search and retrieve detailed adverse event reports involving multiple drugs (drug interactions). …

FAERS_search_reports_by_drug_combination tool specification

Tool Information:

  • Name: FAERS_search_reports_by_drug_combination

  • Type: FDADrugInteractionDetailTool

  • Description: Search and retrieve detailed adverse event reports involving multiple drugs (drug interactions). Returns individual case reports where all specified drugs are present. Only medicinalproducts (list of at least 2 drug names) is required; all other parameters (limit, skip, patientsex, patientagegroup, serious) are optional. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproducts (array) (required) List of at least 2 drug names (required). Reports will include cases where all specified drugs are present.

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • serious (string) (optional) Optional: Filter by event seriousness. Omit this parameter if you don’t want to filter by seriousness.

Example Usage:

query = {
    "name": "FAERS_search_reports_by_drug_combination",
    "arguments": {
        "medicinalproducts": ["item1", "item2"]
    }
}
result = tu.run(query)

FAERS_search_serious_reports_by_drug (Type: FDADrugAdverseEventDetailTool)#

Search and retrieve detailed FAERS case reports for a specific drug. Returns individual case repo…

FAERS_search_serious_reports_by_drug tool specification

Tool Information:

  • Name: FAERS_search_serious_reports_by_drug

  • Type: FDADrugAdverseEventDetailTool

  • Description: Search and retrieve detailed FAERS case reports for a specific drug. Returns individual case reports with patient information, adverse event details, drug information, and report metadata. IMPORTANT: despite the tool name, results are NOT restricted to serious reports unless you pass a seriousness filter – pass serious=’Yes’ for the serious subset. Unfiltered, the mix varies by drug: measured 2026-08 over the first 100 reports, non-serious (serious=’2’) was 12% for acamprosate, 24% for levetiracetam, 39% for ibuprofen and 79% for gadobutrol. Only medicinalproduct is required; all other parameters (serious, limit, skip, seriousnessdeath, seriousnesshospitalization, seriousnesslifethreatening, seriousnessdisabling, patientsex, patientagegroup) are optional. The seriousness* parameters select a specific serious CRITERION and each implies serious=’Yes’. Data source: FDA Adverse Event Reporting System (FAERS). RETURNS AN OBJECT, NOT A BARE LIST: ‘reports’ (this page of case reports), ‘count’ (how many are in it), ‘total_available’ (every report matching the search, taken from openFDA’s own meta.results.total; null when openFDA does not report one), the applied ‘limit’ and ‘skip’, and a ‘truncated’ flag with a ‘truncation_note’ naming the true total whenever more reports exist. ‘limit’ is capped at 100 per request, so any busy query is truncated – measured 2026-08-13, warfarin+amiodarone co-reported returns 10 reports at the default limit against a total of 5941. Never read ‘count’ as the number of matching reports; read ‘total_available’.

Parameters:

  • medicinalproduct (string) (required) Drug name (required).

  • seriousnessdeath (string) (optional) Optional: Filter for reports where death was reported. Set to ‘Yes’ to include only fatal cases.

  • seriousnesshospitalization (string) (optional) Optional: Filter for reports where hospitalization was required. Set to ‘Yes’ to include only cases requiring hospitalization.

  • seriousnesslifethreatening (string) (optional) Optional: Filter for reports where the event was life-threatening. Set to ‘Yes’ to include only life-threatening cases.

  • seriousnessdisabling (string) (optional) Optional: Filter for reports where the event was disabling. Set to ‘Yes’ to include only disabling cases.

  • limit (integer) (optional) Maximum number of reports to return. Must be between 1 and 100.

  • skip (integer) (optional) Number of reports to skip for pagination. Must be non-negative.

  • patientsex (string) (optional) Optional: Filter by patient sex. Omit this parameter if you don’t want to filter by sex.

  • patientagegroup (string) (optional) Optional: Filter by patient age group. Omit this parameter if you don’t want to filter by age.

  • serious (string) (optional) Optional: ‘Yes’ returns only reports FAERS flags as serious (openFDA serious=1), ‘No’ only non-serious ones (serious=2). Omit to return both, which is this tool’s default despite its name.

Example Usage:

query = {
    "name": "FAERS_search_serious_reports_by_drug",
    "arguments": {
        "medicinalproduct": "example_value"
    }
}
result = tu.run(query)