/v1/marketed-products/searchFind US products, one product NDC each, by name or by indexed facts: the drug they contain, a substance, dosage form, route, labeler, brand or generic, and listing status.
AuthorizationstringRequiredBearer token with your API key. Keep the key server-side.
Idempotency-KeystringOptionalMakes a retry count once. 8 to 128 letters, digits and . _ : / + -, starting with a letter or digit. For 24 hours the key is bound to your workspace and the exact request; reusing it for different work is refused with 409.
Values go in the query string; repeat a field to send several values.
qstringOptionalat most 500 charactersA proprietary, generic or ingredient name. Matching ignores case and punctuation. When no name holds q as written, its name words are searched in any order, and its strength and form words filter the products, as in Lisinopril 10 mg tablets. Send NDCs to CODE-LOOKUP.
match_modestringOptionalDefaults to "auto"exact: the whole name. auto and prefix: names that start with the value, whole-name matches first.
drug_rxcuistring or array of stringOptionalat least 1 item · at most 20 itemsProducts DRUG-LOOKUP counts for this drug. Repeat for several, at most 20.
drug_groupstring or array of stringOptionalat least 1 item · at most 20 itemsProducts in one of a drug’s form-and-strength groups (a group_key (fg_ and 32 hex digits) from DRUG-LOOKUP). Repeat for several, at most 20.
contains_substancestring or array of stringOptionalat least 1 item · at most 20 itemsProducts with this UNII as an ingredient in any role or as an active moiety, in the product or a kit part. Repeat for several, at most 20.
dosage_formstring or array of stringOptionalat least 1 item · at most 20 itemsThe product’s own SPL dosage-form code, a hit’s dosage_form.code. Codes match exactly: TABLET does not include TABLET, FILM COATED. Repeat for several, at most 20.
routestring or array of stringOptionalat least 1 item · at most 20 itemsThe product’s own SPL route code, a hit’s routes[].code. Repeat for several, at most 20.
labelerstring or array of stringOptionalat most 300 characters · at least 1 item · at most 20 itemsA labeler name on the product’s label, matched under match_mode. Repeat for several, at most 20.
labeler_codestring or array of stringOptionalat least 1 item · at most 20 itemsThe NDC labeler code, the first part of the product NDC: 0003 or 50090. 00003 is the same as 0003. Repeat for several, at most 20.
brand_genericstringOptionalOnly brand products, or only generic ones (ANDA or NDA authorized generic).
hide_repackagersbooleanOptionalDefaults to falseLeave out products whose label names another company’s source NDC or whose labeler declares a repack or relabel operation.
listing_statusstringOptionalDefaults to "current"current (default): active and unknown listings. active_listing: active only. all: every product, including ended and not_fda_listed.
limitintegerOptionalDefaults to 20min 1 · max 100Products per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of ProductSearchHit objects, one per result; page metadata is in meta. Optional fields are left out when empty; a few return null for unknown, as their sentences say. Dates are YYYY-MM-DD and times ISO 8601 UTC.
product_ndcstringRequiredThe product NDC.
product_namestringRequiredThe proprietary name, or the generic name when the label has none.
generic_namestringOptionalThe generic name on the label.
brand_genericstringOptionalbrand, or generic for an ANDA or an NDA authorized generic.
labelerstringOptionalThe labeler named on the label.
dosage_formCodedNameOptionalThe SPL dosage form, with its code.
routesarray of CodedNameRequiredThe SPL routes of administration, with their codes.
strengthsarray of ProductIngredientRequiredThe active ingredients with their strengths; a kit’s come from its parts.
legal_statusstringOptionalprescription or otc.
product_typestringOptionalvaccine, plasma_derivative, allergenic (an allergenic extract) or cellular_therapy; absent for an ordinary drug label.
dea_schedulestringOptionalFDA’s NDC Directory schedule for this product NDC, else the label’s own.
repackagedbooleanOptionalTrue when the label names another company’s source NDC, or its labeler declares a repack or relabel operation for it.
listing_statusstringRequiredactive_listing, ended, future, unknown, or not_fda_listed when FDA’s NDC Directory does not list the product.
shortage_importbooleanOptionalTrue when FDA lists the product as an unapproved drug for use in a drug shortage: imported or marketed only while the shortage lasts.
set_idsarray of stringRequiredat least 1 itemThe set IDs of the labels that list the product.
matched_nameMatchedNameOptionalWhich of the product’s names q matched, whether whole, and its text.
Errors and limits lists every code and the limits behind them.