Openfda Tools

Configuration File: openfda_tools.json Tool Type: Local Tools Count: 7

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

Available Tools

OpenFDA_search_device_510k (Type: BaseRESTTool)

Search the FDA 510(k) premarket notification database via openFDA. Contains clearances for medica…

OpenFDA_search_device_510k tool specification

Tool Information:

• Name: OpenFDA_search_device_510k

• Type: BaseRESTTool

• Description: Search the FDA 510(k) premarket notification database via openFDA. Contains clearances for medical devices through the 510(k) pathway (substantial equivalence). Returns device names, applicant companies, decision dates, advisory committee classifications, and FDA decision types. Useful for medical device research, competitive landscape analysis, and understanding regulatory pathways for specific device categories.

Parameters:

• search (string) (required) Lucene query for 510(k) devices (e.g., ‘device_name:stethoscope’, ‘applicant:siemens’, ‘decision_date_year:2023’, ‘advisory_committee_description:radiology’)

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 5, max 100)

Example Usage:

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

OpenFDA_search_device_enforcement (Type: BaseRESTTool)

Search the FDA medical device enforcement (recall) database via openFDA. Contains medical device …

OpenFDA_search_device_enforcement tool specification

Tool Information:

• Name: OpenFDA_search_device_enforcement

• Type: BaseRESTTool

• Description: Search the FDA medical device enforcement (recall) database via openFDA. Contains medical device recalls, corrections, and removals. Use Lucene query syntax: ‘classification:”Class I”’ (most serious), ‘status:Ongoing’, ‘recalling_firm:”Medtronic”’. Returns recall details including product description, reason for recall, and distribution pattern. Medical devices include implants, diagnostic equipment, surgical tools, and consumer medical devices.

Parameters:

• search ([‘string’, ‘null’]) (optional) Lucene query for device recalls (e.g., ‘classification:”Class I”’, ‘status:Ongoing’, ‘product_description:pacemaker’, ‘recalling_firm:medtronic’). Leave null to get recent recalls.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 5, max 100)

• count ([‘string’, ‘null’]) (optional) Field to count by (e.g., ‘classification’, ‘status’, ‘recalling_firm.exact’)

Example Usage:

query = {
    "name": "OpenFDA_search_device_enforcement",
    "arguments": {
    }
}
result = tu.run(query)

OpenFDA_search_drug_enforcement (Type: BaseRESTTool)

Search the FDA drug enforcement (recall) database via openFDA. Contains drug recalls, withdrawals…

OpenFDA_search_drug_enforcement tool specification

Tool Information:

• Name: OpenFDA_search_drug_enforcement

• Type: BaseRESTTool

• Description: Search the FDA drug enforcement (recall) database via openFDA. Contains drug recalls, withdrawals, and field corrections submitted to the FDA. Use Lucene query syntax: ‘classification:”Class I”’ (most serious, may cause death), ‘recalling_firm:pfizer’, ‘status:Ongoing’. Returns recall details including reason, product description, distribution pattern, classification, firm, and dates. Use count parameter for frequency analysis (e.g., count=’classification’ to see recall counts by class).

Parameters:

• search ([‘string’, ‘null’]) (optional) Lucene query for drug recalls (e.g., ‘classification:”Class I”’, ‘status:Ongoing’, ‘recalling_firm:pfizer’, ‘reason_for_recall:contamination’). Leave null to get recent recalls.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 5, max 100)

• count ([‘string’, ‘null’]) (optional) Field to count by for frequency analysis (e.g., ‘classification’, ‘recalling_firm.exact’, ‘voluntary_mandated.exact’)

Example Usage:

query = {
    "name": "OpenFDA_search_drug_enforcement",
    "arguments": {
    }
}
result = tu.run(query)

OpenFDA_search_drug_events (Type: BaseRESTTool)

Search the FDA Adverse Event Reporting System (FAERS) database via openFDA for drug safety report…

OpenFDA_search_drug_events tool specification

Tool Information:

• Name: OpenFDA_search_drug_events

• Type: BaseRESTTool

• Description: Search the FDA Adverse Event Reporting System (FAERS) database via openFDA for drug safety reports. Contains 20+ million adverse event reports submitted to the FDA. Use Lucene syntax: ‘patient.drug.medicinalproduct:aspirin’, ‘patient.reaction.reactionmeddrapt:headache’. Returns serious adverse events with outcomes (hospitalization, death), suspect drugs, and reported reactions using MedDRA terminology.

Parameters:

• search (string) (required) Lucene query for adverse event reports (e.g., ‘patient.drug.medicinalproduct:aspirin’, ‘patient.reaction.reactionmeddrapt:”myocardial infarction”’, ‘serious:1 AND patient.drug.medicinalproduct:warfarin’)

• limit ([‘integer’, ‘null’]) (optional) Maximum number of reports to return (default 1, max 100)

• count ([‘string’, ‘null’]) (optional) Field to count by for frequency analysis (e.g., ‘patient.reaction.reactionmeddrapt.exact’ to get most common reactions)

Example Usage:

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

OpenFDA_search_drug_labels (Type: BaseRESTTool)

Search the FDA drug label (SPL - Structured Product Labeling) database via openFDA. Contains appr…

OpenFDA_search_drug_labels tool specification

Tool Information:

• Name: OpenFDA_search_drug_labels

• Type: BaseRESTTool

• Description: Search the FDA drug label (SPL - Structured Product Labeling) database via openFDA. Contains approved prescription and OTC drug labels including indications, warnings, dosage, adverse reactions, contraindications, and pharmacology sections. Use Lucene query syntax: ‘openfda.brand_name:aspirin’, ‘openfda.generic_name:ibuprofen’, ‘openfda.manufacturer_name:pfizer’. Returns label text sections and openFDA cross-references (brand name, generic name, substance name, product type).

Parameters:

• search (string) (required) Lucene query to search drug labels (e.g., ‘openfda.brand_name:aspirin’, ‘openfda.generic_name:metformin’, ‘indications_and_usage:diabetes’, ‘openfda.pharm_class_epc:”beta blocker”’)

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 1, max 100)

Example Usage:

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

OpenFDA_search_drug_ndc (Type: BaseRESTTool)

Search the FDA National Drug Code (NDC) Directory via openFDA. The NDC directory identifies drugs…

OpenFDA_search_drug_ndc tool specification

Tool Information:

• Name: OpenFDA_search_drug_ndc

• Type: BaseRESTTool

• Description: Search the FDA National Drug Code (NDC) Directory via openFDA. The NDC directory identifies drugs listed under Section 510 of the FDA Act, covering finished dosage forms, unfinished APIs, and non-prescription drugs. Returns product/package codes, brand/generic names, dosage forms, routes of administration, active ingredients, and marketing information.

Parameters:

• search (string) (required) Lucene query for NDC products (e.g., ‘brand_name:lipitor’, ‘generic_name:atorvastatin’, ‘active_ingredients.name:metformin’, ‘finished:true AND marketing_status:”Prescription”’)

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 5, max 100)

Example Usage:

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

OpenFDA_search_food_enforcement (Type: BaseRESTTool)

Search the FDA food enforcement (recall) database via openFDA. Contains food recalls, market with…

OpenFDA_search_food_enforcement tool specification

Tool Information:

• Name: OpenFDA_search_food_enforcement

• Type: BaseRESTTool

• Description: Search the FDA food enforcement (recall) database via openFDA. Contains food recalls, market withdrawals, and safety alerts. Use Lucene query syntax: ‘classification:”Class I”’ (most serious), ‘status:Ongoing’, ‘recalling_firm:”Company Name”’. Returns recall details including product description, reason for recall, distribution pattern, and classification. Useful for food safety research, supply chain analysis, and identifying contamination patterns.

Parameters:

• search ([‘string’, ‘null’]) (optional) Lucene query for food recalls (e.g., ‘classification:”Class I”’, ‘reason_for_recall:salmonella’, ‘status:Ongoing’, ‘product_description:peanut’). Leave null to get recent recalls.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 5, max 100)

• count ([‘string’, ‘null’]) (optional) Field to count by (e.g., ‘classification’, ‘state’, ‘recalling_firm.exact’)

Example Usage:

query = {
    "name": "OpenFDA_search_food_enforcement",
    "arguments": {
    }
}
result = tu.run(query)

Navigation

• Available Tools - Back to Tools Overview

• Tool Loading Tutorial - Loading Local Tools