/v1/drugs/searchFind ingredient and multiple-ingredient drugs by official name, brand name or a marketed product’s name, or by ingredient composition. Each hit names its exact ingredients with their own RxCUIs, its brand names and dosage forms, and which name matched.
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 4096 charactersA brand, ingredient or product name, such as Lipitor, atorvastatin or paracetamol. Strength and form words keep drugs with such a product, and combinations can be written in any order, such as hydrocodone/acetaminophen.
ingredient_rxcuisarray of stringOptionalat least 1 item · at most 100 itemsIngredient RxCUIs the drug must contain; composition_match says whether exactly these or at least these.
composition_matchstringOptionalDefaults to "exact"exact: the drug’s ingredients are exactly ingredient_rxcuis. contains: the drug contains them, salts matched to their ingredient.
match_modestringOptionalDefaults to "auto"How q is matched: auto (whole names and names starting with q) or exact (whole names only).
limitintegerOptionalDefaults to 20min 1 · max 100Results per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of DrugSearchHit 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.
rxcuistringRequiredThe drug’s RxCUI.
concept_typestringRequiredIN for one ingredient, PIN for a precise ingredient, MIN for a combination.
preferred_namestringRequiredThe RxNorm preferred name.
ingredientsarray of DrugIngredientRequiredat least 1 itemThe exact ingredient members, each with its RxCUI and type.
brand_namesarray of stringOptionalBrand names of current products, most common first, at most ten.
more_brand_namesbooleanOptionalTrue when the drug has more brand names than the ten shown.
dosage_formsarray of stringOptionalThe dosage forms of the drug’s current products.
has_productsbooleanRequiredFalse for an RxNorm-only drug with no DailyMed product; these come after the others.
matched_nameDrugMatchedNameOptionalWhich of the drug’s names q matched, whether whole, and its text.
Errors and limits lists every code and the limits behind them.