openFDA Drug (Independent Publisher) (Preview)
openFDA is an Elasticsearch-based API that serves public FDA data about nouns like drugs, devices, and foods. Each of these nouns has one or more categories, which serve unique data-such as data about recall enforcement reports, or about adverse events. Every query to the API must go through one endpoint for one kind of data.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | Woong Choi |
[email protected] |
Connector Metadata | |
---|---|
Publisher | Woong Choi |
Website | https://open.fda.gov |
Privacy policy | https://www.fda.gov/about-fda/about-website/website-policies#privacy |
Categories | Data |
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Actions
Drug Adverse Event |
The openFDA drug adverse event API returns data that has been collected from the FDA Adverse Event Reporting System (FAERS), a database that contains information on adverse event and medication error reports submitted to FDA. |
Drug Enforcement |
The openFDA drug enforcement reports API returns data from the FDA Recall Enterprise System (RES), a database that contains information on recall event information submitted to FDA. Currently, this data covers publicly releasable records from 2004-present. The data is updated weekly. |
Drug Labeling |
Drug manufacturers and distributors submit documentation about their products to FDA in the Structured Product Labeling (SPL) format. The openFDA drug product labeling API returns data from this dataset. |
Drug NDC |
The openFDA drug NDC Directory endpoint returns data from the NDC Directory, a database that contains information on the National Drug Code (NDC). FDA publishes the listed NDC numbers and the information submitted as part of the listing information in the NDC Directory which is updated daily. |
DrugsFDA |
DrugsFDA includes most of the drug products approved since 1939. The majority of patient information, labels, approval letters, reviews, and other information are available for drug products approved since 1998. |
Drug Adverse Event
The openFDA drug adverse event API returns data that has been collected from the FDA Adverse Event Reporting System (FAERS), a database that contains information on adverse event and medication error reports submitted to FDA.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search Query
|
search | string |
single |
|
Number of records to be returned
|
limit | integer |
single |
Returns
Name | Path | Type | Description |
---|---|---|---|
disclaimer
|
meta.disclaimer | string |
Disclaimer |
terms
|
meta.terms | string |
Terms of Service |
license
|
meta.license | string |
Data Licensing |
last_updated
|
meta.last_updated | string |
Last Update Date |
skip
|
meta.results.skip | integer |
Number of skipped records |
limit
|
meta.results.limit | integer |
Number of records to be returned |
total
|
meta.results.total | integer |
Number of total records |
results
|
results | array of object |
Results |
receiptdateformat
|
results.receiptdateformat | string |
Receipt date format |
receiver
|
results.receiver | string |
Receiver |
seriousnessdeath
|
results.seriousnessdeath | string |
Adverse event resulted in death |
companynumb
|
results.companynumb | string |
Identifier for the company providing the report. |
receivedateformat
|
results.receivedateformat | string |
Encoding format of the transmissiondate field |
reportercountry
|
results.primarysource.reportercountry | string |
Country from which the report was submitted. |
qualification
|
results.primarysource.qualification | string |
Category of individual who submitted the report. |
transmissiondateformat
|
results.transmissiondateformat | string |
Encoding format of the transmissiondate field. |
fulfillexpeditecriteria
|
results.fulfillexpeditecriteria | string |
Identifies expedited reports (those that were processed within 15 days). |
safetyreportid
|
results.safetyreportid | string |
The 8-digit Safety Report ID number, also known as the case report number or case ID. |
senderorganization
|
results.sender.senderorganization | string |
Name of the organization sending the report. |
receivedate
|
results.receivedate | string |
Date that the report was first received by FDA. |
patientonsetage
|
results.patient.patientonsetage | string |
Age of the patient when the event first occured. |
patientonsetageunit
|
results.patient.patientonsetageunit | string |
The unit for the interval in the field patientonsetage. |
patientsex
|
results.patient.patientsex | string |
The sex of the patient. |
patientdeathdateformat
|
results.patient.patientdeath.patientdeathdateformat | string |
Encoding format of the field patientdeathdate. |
patientdeathdate
|
results.patient.patientdeath.patientdeathdate | string |
If the patient died, the date that the patient died |
reaction
|
results.patient.reaction | array of object |
Reaction |
reactionmeddrapt
|
results.patient.reaction.reactionmeddrapt | string |
Patient reaction, as a MedDRA term. |
drug
|
results.patient.drug | array of object |
Drug |
drugcharacterization
|
results.patient.drug.drugcharacterization | string |
Reported role of the drug in the adverse event report. |
medicinalproduct
|
results.patient.drug.medicinalproduct | string |
Drug name. |
drugauthorizationnumb
|
results.patient.drug.drugauthorizationnumb | string |
Drug authorization or application number (NDA or ANDA), if provided. |
drugadministrationroute
|
results.patient.drug.drugadministrationroute | string |
The drug's route of administration. |
drugindication
|
results.patient.drug.drugindication | string |
Indication for the drug's use. |
transmissiondate
|
results.transmissiondate | string |
Date that the record was created. |
serious
|
results.serious | string |
Seriousness of the adverse event. |
receiptdate
|
results.receiptdate | string |
Date that the most recent information in the report was received by FDA. |
Drug Enforcement
The openFDA drug enforcement reports API returns data from the FDA Recall Enterprise System (RES), a database that contains information on recall event information submitted to FDA. Currently, this data covers publicly releasable records from 2004-present. The data is updated weekly.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search Query
|
search | string |
single |
|
Number of records to be returned
|
limit | integer |
single |
Returns
Name | Path | Type | Description |
---|---|---|---|
disclaimer
|
meta.disclaimer | string |
Disclaimer |
terms
|
meta.terms | string |
Terms of Service |
license
|
meta.license | string |
Data Licensing |
last_updated
|
meta.last_updated | string |
Last Update Date |
skip
|
meta.results.skip | integer |
Number of skipped records |
limit
|
meta.results.limit | integer |
Number of records to be returned |
total
|
meta.results.total | integer |
Number of total records |
results
|
results | array of object |
Results |
country
|
results.country | string |
The country in which the recalling firm is located. |
city
|
results.city | string |
The city in which the recalling firm is located. |
address_1
|
results.address_1 | string |
This is an .exact field. It has been indexed both as its exact string content, and also tokenized. |
reason_for_recall
|
results.reason_for_recall | string |
Information describing how the product is defective and violates the FD&C Act or related statutes. |
address_2
|
results.address_2 | string |
This is an .exact field. It has been indexed both as its exact string content, and also tokenized. |
product_quantity
|
results.product_quantity | string |
The amount of defective product subject to recall. |
code_info
|
results.code_info | string |
A list of all lot and/or serial numbers, product numbers, packer or manufacturer numbers, sell or use by dates, etc., which appear on the product or its labeling. |
center_classification_date
|
results.center_classification_date | string |
Center classification date |
distribution_pattern
|
results.distribution_pattern | string |
General area of initial distribution such as, “Distributors in 6 states: NY, VA, TX, GA, FL and MA; the Virgin Islands; Canada and Japan”. The term “nationwide” is defined to mean the fifty states or a significant portion. Note that subsequent distribution by the consignees to other parties may not be included. |
state
|
results.state | string |
The U.S. state in which the recalling firm is located. |
product_description
|
results.product_description | string |
Brief description of the product being recalled. |
report_date
|
results.report_date | string |
Date that the FDA issued the enforcement report for the product recall. |
classification
|
results.classification | string |
Numerical designation (I, II, or III) that is assigned by FDA to a particular product recall that indicates the relative degree of health hazard. |
recalling_firm
|
results.recalling_firm | string |
The firm that initiates a recall or, in the case of an FDA requested recall or FDA mandated recall, the firm that has primary responsibility for the manufacture and (or) marketing of the product to be recalled. |
recall_number
|
results.recall_number | string |
A numerical designation assigned by FDA to a specific recall event used for tracking purposes. |
initial_firm_notification
|
results.initial_firm_notification | string |
The method(s) by which the firm initially notified the public or their consignees of a recall. A consignee is a person or firm named in a bill of lading to whom or to whose order the product has or will be delivered. |
product_type
|
results.product_type | string |
Product type |
event_id
|
results.event_id | string |
A numerical designation assigned by FDA to a specific recall event used for tracking purposes. |
termination_date
|
results.termination_date | string |
Termination date |
more_code_info
|
results.more_code_info | string |
More code info |
recall_initiation_date
|
results.recall_initiation_date | string |
Date that the firm first began notifying the public or their consignees of the recall. |
postal_code
|
results.postal_code | string |
Postal code |
voluntary_mandated
|
results.voluntary_mandated | string |
Describes who initiated the recall. Recalls are almost always voluntary, meaning initiated by a firm. A recall is deemed voluntary when the firm voluntarily removes or corrects marketed products or the FDA requests the marketed products be removed or corrected. A recall is mandated when the firm was ordered by the FDA to remove or correct the marketed products, under section 518(e) of the FD&C Act, National Childhood Vaccine Injury Act of 1986, 21 CFR 1271.440, Infant Formula Act of 1980 and its 1986 amendments, or the Food Safety Modernization Act (FSMA). |
status
|
results.status | string |
This is an .exact field. It has been indexed both as its exact string content, and also tokenized. |
Drug Labeling
Drug manufacturers and distributors submit documentation about their products to FDA in the Structured Product Labeling (SPL) format. The openFDA drug product labeling API returns data from this dataset.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search Query
|
search | string |
single |
|
Number of records to be returned
|
limit | integer |
single |
Returns
Name | Path | Type | Description |
---|---|---|---|
disclaimer
|
meta.disclaimer | string |
Disclaimer |
terms
|
meta.terms | string |
Terms of Service |
license
|
meta.license | string |
Data Licensing |
last_updated
|
meta.last_updated | string |
Last Update Date |
skip
|
meta.results.skip | integer |
Number of skipped records |
limit
|
meta.results.limit | integer |
Number of records to be returned |
total
|
meta.results.total | integer |
Number of total records |
results
|
results | array of object |
Results |
effective_time
|
results.effective_time | string |
Date reference to the particular version of the labeling document. |
inactive_ingredient
|
results.inactive_ingredient | array of string |
A list of inactive, non-medicinal ingredients in a drug product. |
references
|
results.references | array of string |
This field may contain references when prescription drug labeling must summarize or otherwise relay on a recommendation by an authoritative scientific body, or on a standardized methodology, scale, or technique, because the information is important to prescribing decisions. |
purpose
|
results.purpose | array of string |
Information about the drug product's indications for use. |
keep_out_of_reach_of_children
|
results.keep_out_of_reach_of_children | array of string |
Information pertaining to whether the product should be kept out of the reach of children, and instructions about what to do in the case of accidental contact or ingestion, if appropriate. |
warnings
|
results.warnings | array of string |
Information about serious adverse reactions and potential safety hazards, including limitations in use imposed by those hazards and steps that should be taken if they occur. |
spl_product_data_elements
|
results.spl_product_data_elements | array of string |
Usually a list of ingredients in a drug product. |
other_safety_information
|
results.other_safety_information | array of string |
Information about safe use and handling of the product that may not have been specified in another field. |
version
|
results.version | string |
A sequentially increasing number identifying the particular version of a document, starting with 1. |
dosage_and_administration
|
results.dosage_and_administration | array of string |
Information about the drug product's dosage and administration recommendations, including starting dose, dose range, titration regimens, and any other clinically sigificant information that affects dosing recommendations. |
pregnancy_or_breast_feeding
|
results.pregnancy_or_breast_feeding | array of string |
Documentation forthcoming. |
stop_use
|
results.stop_use | array of string |
Information about when use of the drug product should be discontinued immediately and a doctor consulted. Includes information about any signs of toxicity or other reactions that would necessitate immediately discontinuing use of the product. |
package_label_principal_display_panel
|
results.package_label_principal_display_panel | array of string |
The content of the principal display panel of the product package, usually including the product's name, dosage forms, and other key information about the drug product. |
indications_and_usage
|
results.indications_and_usage | array of string |
A statement of each of the drug product's indications for use, such as for the treatment, prevention, mitigation, cure, or diagnosis of a disease or condition, or of a manifestation of a recognized disease or condition, or for the relief of symptoms associated with a recognized disease or condition. This field may also describe any relevant limitations of use. |
set_id
|
results.set_id | string |
The Set ID, A globally unique identifier (GUID) for the labeling, stable across all versions or revisions. |
id
|
results.id | string |
The document ID, A globally unique identifier (GUID) for the particular revision of a labeling document. |
active_ingredient
|
results.active_ingredient | array of string |
A list of the active, medicinal ingredients in the drug product. |
dosage_and_administration_table
|
results.dosage_and_administration_table | array of string |
Information about the drug product's dosage and administration recommendations, including starting dose, dose range, titration regimens, and any other clinically sigificant information that affects dosing recommendations. |
Drug NDC
The openFDA drug NDC Directory endpoint returns data from the NDC Directory, a database that contains information on the National Drug Code (NDC). FDA publishes the listed NDC numbers and the information submitted as part of the listing information in the NDC Directory which is updated daily.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search Query
|
search | string |
single |
|
Number of records to be returned
|
limit | integer |
single |
Returns
Name | Path | Type | Description |
---|---|---|---|
disclaimer
|
meta.disclaimer | string |
Disclaimer |
terms
|
meta.terms | string |
Terms of Service |
license
|
meta.license | string |
Data Licensing |
last_updated
|
meta.last_updated | string |
Last Update Date |
skip
|
meta.results.skip | integer |
Number of skipped records |
limit
|
meta.results.limit | integer |
Number of records to be returned |
total
|
meta.results.total | integer |
Number of total records |
results
|
results | array of object |
Results |
product_ndc
|
results.product_ndc | string |
The labeler manufacturer code and product code segments of the NDC number, separated by a hyphen. |
generic_name
|
results.generic_name | string |
Generic name(s) of the drug product. |
labeler_name
|
results.labeler_name | string |
Labeler name of the drug product. |
brand_name
|
results.brand_name | string |
Brand or trade name of the drug product. |
active_ingredients
|
results.active_ingredients | array of object |
Active Ingredients |
name
|
results.active_ingredients.name | string |
The names of the active, medicinal ingredients in the drug product. |
strength
|
results.active_ingredients.strength | string |
The strength of the active, medicinal ingredients in the drug product. |
finished
|
results.finished | boolean |
finished |
packaging
|
results.packaging | array of object |
Packaging |
package_ndc
|
results.packaging.package_ndc | string |
This number, known as the NDC, identifies the labeler, product, and trade package size. The first segment, the labeler code, is assigned by the FDA. A labeler is any firm that manufactures (including repackers or relabelers), or distributes (under its own name) the drug. |
description
|
results.packaging.description | string |
A description of the size and type of packaging in sentence form. Multilevel packages will have the descriptions concatenated together. |
marketing_start_date
|
results.packaging.marketing_start_date | string |
This is the date that the labeler indicates was the start of its marketing of the drug product. |
sample
|
results.packaging.sample | boolean |
Indicates whether this is a sample packaging or not. |
listing_expiration_date
|
results.listing_expiration_date | string |
This is the date when the listing record will expire if not updated or certified by the firm. |
manufacturer_name
|
results.openfda.manufacturer_name | array of string |
Name of manufacturer or company that makes this drug product, corresponding to the labeler code segment of the NDC. |
rxcui
|
results.openfda.rxcui | array of string |
The RxNorm Concept Unique Identifier. RxCUI is a unique number that describes a semantic concept about the drug product, including its ingredients, strength, and dose forms. |
spl_set_id
|
results.openfda.spl_set_id | array of string |
Unique identifier for the Structured Product Label for a product, which is stable across versions of the label. Also referred to as the set ID. |
nui
|
results.openfda.nui | array of string |
Unique identifier applied to a drug concept within the National Drug File Reference Terminology (NDF-RT). |
pharm_class_epc
|
results.openfda.pharm_class_epc | array of string |
Established pharmacologic class associated with an approved indication of an active moiety (generic drug) that the FDA has determined to be scientifically valid and clinically meaningful. Takes the form of the pharmacologic class, followed by [EPC] (such as Thiazide Diuretic [EPC] or Tumor Necrosis Factor Blocker [EPC]. |
pharm_class_pe
|
results.openfda.pharm_class_pe | array of string |
Physiologic effect or pharmacodynamic effect—tissue, organ, or organ system level functional activity—of the drug's established pharmacologic class. Takes the form of the effect, followed by [PE] (such as Increased Diuresis [PE] or Decreased Cytokine Activity [PE]. |
unii
|
results.openfda.unii | array of string |
Unique Ingredient Identifier, which is a non-proprietary, free, unique, unambiguous, non-semantic, alphanumeric identifier based on a substance's molecular structure and/or descriptive information. |
marketing_category
|
results.marketing_category | string |
Product types are broken down into several potential Marketing Categories, such as NDA/ANDA/BLA, OTC Monograph, or Unapproved Drug. |
dosage_form
|
results.dosage_form | string |
The drug's dosage form. There is no standard, but values may include terms like tablet or solution for injection. |
spl_id
|
results.spl_id | string |
Unique identifier for a particular version of a Structured Product Label for a product. Also referred to as the document ID. |
product_type
|
results.product_type | string |
Type of drug product |
route
|
results.route | array of string |
The route of administation of the drug product. |
marketing_start_date
|
results.marketing_start_date | string |
This is the date that the labeler indicates was the start of its marketing of the drug product. |
product_id
|
results.product_id | string |
ProductID is a concatenation of the NDC product code and SPL documentID. |
application_number
|
results.application_number | string |
This corresponds to the NDA, ANDA, or BLA number reported by the labeler for products which have the corresponding Marketing Category designated. If the designated Marketing Category is OTC Monograph Final or OTC Monograph Not Final, then the application number will be the CFR citation corresponding to the appropriate Monograph (e.g. “part 341”). For unapproved drugs, this field will be null. |
brand_name_base
|
results.brand_name_base | string |
The base of the brand name excluding its suffix. |
pharm_class
|
results.pharm_class | array of string |
These are the reported pharmacological class categories corresponding to the SubstanceNames listed above. |
DrugsFDA
DrugsFDA includes most of the drug products approved since 1939. The majority of patient information, labels, approval letters, reviews, and other information are available for drug products approved since 1998.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Search Query
|
search | string |
single |
|
Number of records to be returned
|
limit | integer |
single |
Returns
Name | Path | Type | Description |
---|---|---|---|
disclaimer
|
meta.disclaimer | string |
Disclaimer |
terms
|
meta.terms | string |
Terms of Service |
license
|
meta.license | string |
Data Licensing |
last_updated
|
meta.last_updated | string |
Last Update Date |
skip
|
meta.results.skip | integer |
Number of skipped records |
limit
|
meta.results.limit | integer |
Number of records to be returned |
total
|
meta.results.total | integer |
Number of total records |
results
|
results | array of object |
Results |
submissions
|
results.submissions | array of object |
Submissions |
submission_type
|
results.submissions.submission_type | string |
The type of the individual submission. Used in combination with submission_number. |
submission_number
|
results.submissions.submission_number | string |
A unique identifier for each submission under that application. |
submission_status
|
results.submissions.submission_status | string |
The current status of this submission. |
submission_status_date
|
results.submissions.submission_status_date | string |
The date the status was applied to the submission. |
submission_class_code
|
results.submissions.submission_class_code | string |
The Submission Classification Code, previously known as the Chemistry Classification Code, is assigned as a “Type” code. |
submission_class_code_description
|
results.submissions.submission_class_code_description | string |
The Submission Classification Code, previously known as the Chemistry Classification Code, is assigned as a “Type” code. This is a full description of the classification code. |
application_number
|
results.application_number | string |
This corresponds to the NDA, ANDA, or BLA number reported by the labeler for products which have the corresponding Marketing Category designated. If the designated Marketing Category is OTC Monograph Final or OTC Monograph Not Final, then the application number will be the CFR citation corresponding to the appropriate Monograph (e.g. “part 341”). For unapproved drugs, this field will be null. |
sponsor_name
|
results.sponsor_name | string |
The company that submitted an application to FDA for approval to market the drug product in the United States. |
products
|
results.products | array of object |
Products |
product_number
|
results.products.product_number | string |
A product number is assigned to each drug product associated with an NDA (New Drug Application), ANDA (Abbreviated New Drug Application) and Biologic License Application (BLA) . If a drug product is available in multiple strengths, there are multiple product numbers. |
reference_drug
|
results.products.reference_drug | string |
Indicates whether the drug product is a reference drug. |
brand_name
|
results.products.brand_name | string |
Brand or trade name of the drug product. |
active_ingredients
|
results.products.active_ingredients | array of object |
Active ingredients |
name
|
results.products.active_ingredients.name | string |
The names of the active, medicinal ingredients in the drug product. |
strength
|
results.products.active_ingredients.strength | string |
The strength of the active, medicinal ingredients in the drug product. |
reference_standard
|
results.products.reference_standard | string |
Indicates whether the drug product is a reference standard. |
dosage_form
|
results.products.dosage_form | string |
The drug’s dosage form. There is no standard, but values may include terms like tablet or solution for injection. |
route
|
results.products.route | string |
The route of administation of the drug product. |
marketing_status
|
results.products.marketing_status | string |
Indicates how a drug product is sold in the United States. |