RxNorm
App · 20 actions
Look up U.S. clinical drugs in RxNorm, the National Library of Medicine's standard drug names: find a drug's RxCUI from a name or another code, get its ingredients, brands, forms and NDCs, check an NDC, and explore drug classes with RxClass. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Find approximate matches | Find the drugs whose names come closest to what was typed, even misspelled, abbreviated or out of order (e.g. 'zocor 10 mg'), best match first, each with its RxCUI, RxNorm name, term type and score. |
| Find brands by ingredients | Find the brand names made of exactly the given ingredients, e.g. Zyrtec-D for cetirizine and pseudoephedrine. |
| Find concepts by code | Find the RxNorm concepts another vocabulary's code stands for: an NDC, an ATC code, a SNOMED CT concept, an FDA application number (NDA, ANDA), a UNII, a DrugBank id and more. |
| Find concepts by name | Find the RxNorm concept for a drug name, such as 'Lipitor 10 MG Oral Tablet' or 'atorvastatin', and get its RxCUI (the number the other actions take), full name and term type. |
| Find drug classes | Find drug classes by name, as a whole name or synonym (e.g. 'HMG CoA reductase inhibitors') or by words the name contains (e.g. 'statin'), optionally of chosen kinds, each with the class id the other class actions take. |
| Get all related concepts | Get every concept related to a concept, of every term type: its ingredients, brand names, dose forms, components, clinical and branded drugs and packs. |
| Get class ancestors | Get the classes a drug class sits under, up to the top of its hierarchy, with each link from a class to its parent, e.g. C10AA under C10A under C10 under the cardiovascular system. |
| Get class members | List the drugs in a drug class, e.g. every statin in ATC class C10AA or every drug that may treat a disease. |
| Get class tree | Get every class under a drug class, all the way down, each with its parent and depth, e.g. the statins, fibrates and others under ATC class C10. |
| Get concept | Get a current RxNorm concept's name, synonym and term type from its RxCUI. |
| Get concept history | Find out whether an RxCUI is still current, or was retired or remapped (and to what), when it was active, and what it is made of: ingredients and strengths, and dose forms. |
| Get concept properties | Get everything RxNorm records about a concept: its names and synonyms, its codes in other vocabularies (NDA number, FDA label id...), attributes such as strength, prescribability and controlled-substance schedule, and the vocabularies that list it. |
| Get drug classes | Get the classes a drug belongs to, by its name or RxCUI: its ATC class, pharmacologic class, mechanism of action, the diseases it may treat or must not be used with, and more, each with the source that says so. |
| Get drug products | List every drug product for an ingredient, brand or drug name: the clinical and branded drugs with their strengths and forms, and generic and branded packs, each with its RxCUI and the name used on prescriptions. |
| Get NDC properties | Get packaging and labelling for a National Drug Code, or for every NDC of a drug or FDA label: the package description, labeler, marketing category and status, and the pill's colour, shape, size and imprint. |
| Get NDC status | Check a National Drug Code: whether it is active, obsolete or unknown to RxNorm, which drug it belongs to now, and which drugs it belonged to before. |
| Get NDCs | Get the National Drug Codes (NDCs, the codes on U.S. drug packages) of a concept: the current ones, or every one ever linked to it with the RxNorm releases it was linked in. |
| Get related concepts | Get the concepts of chosen term types related to a concept, e.g. a branded drug's ingredient (IN), brand name (BN) and generic equivalent (SCD), or every branded drug (SBD) of an ingredient. |
| Get spelling suggestions | Get the drug names RxNorm knows that are spelled like a misspelled one, e.g. 'ambien' for 'ambienn'. |
| List class types | List the kinds of drug class RxClass has (ATC classes, pharmacologic classes, mechanisms of action, diseases...), each with the source that defines it. |
Find approximate matches
Find the drugs whose names come closest to what was typed, even misspelled, abbreviated or out of order (e.g. 'zocor 10 mg'), best match first, each with its RxCUI, RxNorm name, term type and score.
Inputs
- Drug name
termtextRequired - What to match, e.g. zocor 10 mg.
- How many names
max_entriesnumber - Roughly how many matching names to look at, 1 to 100 (several can belong to one drug). Defaults to 20.From 1 to 100.
- Only drugs RxNorm names itself
rxnorm_concepts_onlytrue/false - On by default. Turn off to also match drugs only other drug vocabularies name.
Outputs
countnumber- How many came back
matcheslist- The closest drugs, best first
Example output
{
"count": 1,
"matches": [
{
"matched_name": "Zocor 10 MG Oral Tablet",
"name": "simvastatin 10 MG Oral Tablet [Zocor]",
"rank": 1.0,
"rxcui": "104490",
"score": 13.04,
"sources": [
"GS",
"RXNORM",
"MMSL"
],
"term_type": "Branded drug",
"tty": "SBD"
}
]
}Find brands by ingredients
Find the brand names made of exactly the given ingredients, e.g. Zyrtec-D for cetirizine and pseudoephedrine.
Inputs
- Ingredient RxCUIs
ingredient_rxcuislistRequired - The RxCUIs of the ingredients, e.g. 20610 (cetirizine) and 8896 (pseudoephedrine).
Outputs
brandslist- The brand names (term type BN)
countnumber- How many came back
Example output
{
"brands": [
{
"language": "ENG",
"name": "Zyrtec-D",
"rxcui": "353102",
"suppressed": false,
"synonym": null,
"term_type": "Brand name",
"tty": "BN"
}
],
"count": 1
}Find concepts by code
Find the RxNorm concepts another vocabulary's code stands for: an NDC, an ATC code, a SNOMED CT concept, an FDA application number (NDA, ANDA), a UNII, a DrugBank id and more.
Inputs
- Code type
id_typetextRequired - Which vocabulary the code is from, e.g. NDC or ATC.
- Code
codetextRequired - The code, e.g. C10AA05 (ATC) or 00071015523 (NDC).
Outputs
conceptslist- The concepts the code stands for
countnumber- How many came back
summarytext- One line saying what was found
Example output
{
"concepts": [
{
"language": "ENG",
"name": "atorvastatin",
"rxcui": "83367",
"suppressed": false,
"synonym": null,
"term_type": "Ingredient",
"tty": "IN"
}
],
"count": 1,
"summary": "1 concept found"
}Find concepts by name
Find the RxNorm concept for a drug name, such as 'Lipitor 10 MG Oral Tablet' or 'atorvastatin', and get its RxCUI (the number the other actions take), full name and term type. Matches the exact name, or the name normalized to ignore word order, case and plurals.
Inputs
- Drug name
nametextRequired - The drug's name, e.g. Lipitor 10 MG Oral Tablet or atorvastatin.
- Match
matchtext - Exact name, normalized name, or exact first and normalized if none.One of:
exact_or_normalized(Exact, else normalized (default)),exact(Exact name only),normalized(Normalized (ignores word order, case and plurals)).
Outputs
conceptslist- The concepts found
countnumber- How many came back
summarytext- One line saying what was found
Example output
{
"concepts": [
{
"language": "ENG",
"name": "atorvastatin 10 MG Oral Tablet [Lipitor]",
"rxcui": "617314",
"suppressed": false,
"synonym": "Lipitor 10 MG Oral Tablet",
"term_type": "Branded drug",
"tty": "SBD"
}
],
"count": 1,
"summary": "1 concept found"
}Find drug classes
Find drug classes by name, as a whole name or synonym (e.g. 'HMG CoA reductase inhibitors') or by words the name contains (e.g. 'statin'), optionally of chosen kinds, each with the class id the other class actions take.
Inputs
- Class name
nametextRequired - The name, or words in it, e.g. HMG CoA reductase inhibitors.
- Match
matchtext - Whole name or synonym, or names containing the words.One of:
whole(Whole name or synonym (default)),contains(Name contains the words). - Kinds of class
class_typeslist - Only classes of these kinds, e.g. EPC. Leave empty for all.
- At most
limitnumber - How many classes to return, 1 to 500. Defaults to 100.From 1 to 500.
Outputs
classeslist- The classes found
countnumber- How many came back
total_foundnumber- How many matched, before 'At most' was applied
Example output
{
"classes": [
{
"class_id": "C10AA",
"class_name": "HMG CoA reductase inhibitors",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class"
}
],
"count": 1,
"total_found": 1
}Get all related concepts
Get every concept related to a concept, of every term type: its ingredients, brand names, dose forms, components, clinical and branded drugs and packs.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
Outputs
conceptslist- The related concepts, by term type
countnumber- How many came back
rxcuitext- The RxCUI that was asked about
summarytext- One line saying what was found
Example output
{
"concepts": [
{
"language": "ENG",
"name": "atorvastatin",
"rxcui": "83367",
"suppressed": false,
"synonym": null,
"term_type": "Ingredient",
"tty": "IN"
}
],
"count": 1,
"rxcui": "617314",
"summary": "1 related concept"
}Get class ancestors
Get the classes a drug class sits under, up to the top of its hierarchy, with each link from a class to its parent, e.g. C10AA under C10A under C10 under the cardiovascular system.
Inputs
- Class ID
class_idtextRequired - The class's id, e.g. C10AA. 'Find drug classes' gives it.
- Kind of class
class_typetext - The class's kind, e.g. DISEASE, when its id is used by more than one kind.
Outputs
ancestorslist- The classes above it
countnumber- How many came back
edgeslist- Each class's link to its parent
requested_classobject- The class asked about
Example output
{
"ancestors": [
{
"class_id": "C10A",
"class_name": "LIPID MODIFYING AGENTS, PLAIN",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class"
}
],
"count": 1,
"edges": [
{
"class_id": "C10AA",
"parent_id": "C10A"
}
],
"requested_class": {
"class_id": "C10AA",
"class_name": "HMG CoA reductase inhibitors",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class"
}
}Get class members
List the drugs in a drug class, e.g. every statin in ATC class C10AA or every drug that may treat a disease. The source that defines the class is used unless you choose another.
Inputs
- Class ID
class_idtextRequired - The class's id, e.g. C10AA. 'Find drug classes' gives it.
- Relationship source
rela_sourcetext - Whose links to use, e.g. ATC or MEDRT. Leave empty for the class's own.
- Relationship
relatext - Only this kind of link, e.g. may_treat or has_epc.
- Term types
term_typeslist - Only members of these term types. Leave empty for ingredients.One or more of:
IN(Ingredient (IN)),PIN(Precise ingredient (PIN)),MIN(Multiple ingredients (MIN)),BN(Brand name (BN)),SCD(Clinical drug (SCD)),SBD(Branded drug (SBD)),SCDC(Clinical drug component (SCDC)),SBDC(Branded drug component (SBDC)),SCDF(Clinical drug form (SCDF)),SBDF(Branded drug form (SBDF)), and 9 more. - Include subclasses' members
include_indirecttrue/false - Also list drugs that belong through a class under this one.
Outputs
class_idtext- The class asked about
countnumber- How many came back
memberslist- The drugs in the class
rela_sourcetext- The relationship source used
Example output
{
"class_id": "C10AA",
"count": 1,
"members": [
{
"name": "atorvastatin",
"relation": "DIRECT",
"rxcui": "83367",
"source_id": "C10AA05",
"source_name": "atorvastatin",
"tty": "IN"
}
],
"rela_source": "ATC"
}Get class tree
Get every class under a drug class, all the way down, each with its parent and depth, e.g. the statins, fibrates and others under ATC class C10.
Inputs
- Class ID
class_idtextRequired - The class's id, e.g. C10AA. 'Find drug classes' gives it.
Outputs
countnumber- How many came back
descendantslist- Every class under it, depth first
requested_classobject- The class asked about
Example output
{
"count": 1,
"descendants": [
{
"class_id": "C10AA",
"class_name": "HMG CoA reductase inhibitors",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class",
"depth": 1,
"parent_id": "C10A"
}
],
"requested_class": {
"class_id": "C10A",
"class_name": "LIPID MODIFYING AGENTS, PLAIN",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class"
}
}Get concept
Get a current RxNorm concept's name, synonym and term type from its RxCUI.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
Outputs
conceptobject- An RxNorm concept
summarytext- One line saying what was found
Example output
{
"concept": {
"language": "ENG",
"name": "atorvastatin 10 MG Oral Tablet [Lipitor]",
"rxcui": "617314",
"suppressed": false,
"synonym": "Lipitor 10 MG Oral Tablet",
"term_type": "Branded drug",
"tty": "SBD"
},
"summary": "atorvastatin 10 MG Oral Tablet [Lipitor] (SBD)"
}Get concept history
Find out whether an RxCUI is still current, or was retired or remapped (and to what), when it was active, and what it is made of: ingredients and strengths, and dose forms. Works for RxCUIs that no longer exist.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
Outputs
active_fromtext- When it became active (YYYY-MM)
active_untiltext- When it stopped being active (YYYY-MM)
dose_form_groupslist- Its dose form groups, e.g. Pill
dose_formslist- Its dose forms, e.g. Oral Tablet
first_releasetext- The first RxNorm release it was in (YYYY-MM)
ingredientslist- Its ingredients and strengths
is_brandedtrue/false- Whether it is a branded drug
is_currenttrue/false- Whether it is in the current RxNorm release
is_multiple_ingredienttrue/false- Whether it has several ingredients
last_releasetext- The last release it was in, if it has left (YYYY-MM)
nametext- The concept's name
remapped_ontext- When it was remapped (YYYY-MM)
remapped_tolist- The concepts it was remapped to
rxcuitext- The RxCUI that was asked about
sourcetext- The vocabulary it comes from, e.g. RXNORM
statustext- Active, Obsolete, Remapped, Quantified, NotCurrent...
summarytext- One line saying what was found
ttytext- Its term type code
Example output
{
"active_from": "2006-05",
"active_until": null,
"dose_form_groups": [
"Oral Product",
"Pill"
],
"dose_forms": [
"Oral Tablet"
],
"first_release": "2006-05",
"ingredients": [
{
"active_ingredient_name": "atorvastatin calcium",
"active_ingredient_rxcui": "83366",
"ingredient_name": "atorvastatin",
"ingredient_rxcui": "83367",
"per": "1 EACH",
"strength": "10 MG"
}
],
"is_branded": true,
"is_current": true,
"is_multiple_ingredient": false,
"last_release": null,
"name": "atorvastatin 10 MG Oral Tablet [Lipitor]",
"remapped_on": null,
"remapped_to": [],
"rxcui": "617314",
"source": "RXNORM",
"status": "Active",
"summary": "atorvastatin 10 MG Oral Tablet [Lipitor]: Active",
"tty": "SBD"
}Get concept properties
Get everything RxNorm records about a concept: its names and synonyms, its codes in other vocabularies (NDA number, FDA label id...), attributes such as strength, prescribability and controlled-substance schedule, and the vocabularies that list it.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Kinds of property
categorieslist - Which kinds to get. Leave empty for all of them.One or more of:
NAMES(Names and synonyms),CODES(Codes in other vocabularies),ATTRIBUTES(Attributes (strength, schedule...)),SOURCES(Source vocabularies).
Outputs
countnumber- How many came back
propertieslist- The properties
rxcuitext- The RxCUI that was asked about
Example output
{
"count": 2,
"properties": [
{
"category": "ATTRIBUTES",
"name": "AVAILABLE_STRENGTH",
"value": "10 MG"
},
{
"category": "CODES",
"name": "NDA",
"value": "NDA020702"
}
],
"rxcui": "617314"
}Get drug classes
Get the classes a drug belongs to, by its name or RxCUI: its ATC class, pharmacologic class, mechanism of action, the diseases it may treat or must not be used with, and more, each with the source that says so.
Inputs
- Drug name
drug_nametext - The drug, e.g. atorvastatin. Give this or the RxCUI.
- RxCUI
rxcuitext - The drug's RxCUI, e.g. 83367. Used instead of the name when given.
- Relationship source
rela_sourcetext - Only links from this source, e.g. ATC, DAILYMED or MEDRT.
- Relationship
relatext - Only this kind of link, e.g. may_treat or has_epc.
Outputs
classeslist- The classes
countnumber- How many came back
Example output
{
"classes": [
{
"class_id": "C10AA",
"class_name": "HMG CoA reductase inhibitors",
"class_type": "ATC1-4",
"class_type_name": "Anatomical Therapeutic Chemical class",
"drug_name": "atorvastatin",
"drug_rxcui": "83367",
"drug_tty": "IN",
"rela": null,
"rela_source": "ATC"
}
],
"count": 1
}Get drug products
List every drug product for an ingredient, brand or drug name: the clinical and branded drugs with their strengths and forms, and generic and branded packs, each with its RxCUI and the name used on prescriptions.
Inputs
- Ingredient, brand or drug
nametextRequired - e.g. cetirizine, Zyrtec or cetirizine 10 MG Oral Tablet.
Outputs
countnumber- How many came back
productslist- The drug products
summarytext- One line saying what was found
Example output
{
"count": 1,
"products": [
{
"language": "ENG",
"name": "cetirizine hydrochloride 10 MG Disintegrating Oral Tablet [Zyrtec]",
"prescribable_name": "ZyrTEC 10 MG Disintegrating Oral Tablet",
"rxcui": "1011485",
"suppressed": false,
"synonym": "Zyrtec 10 MG Disintegrating Oral Tablet",
"term_type": "Branded drug",
"tty": "SBD"
}
],
"summary": "1 drug product for cetirizine"
}Get NDC properties
Get packaging and labelling for a National Drug Code, or for every NDC of a drug or FDA label: the package description, labeler, marketing category and status, and the pill's colour, shape, size and imprint.
Inputs
- NDC, RxCUI or label id
identifiertextRequired - An NDC (e.g. 0071-0155-23), an RxCUI for all of a drug's NDCs, or an FDA label set id.
- NDC status
statuslist - Which NDCs to include. Defaults to active ones.One or more of:
active(Active (default)),obsolete,alien(Only in other vocabularies),ALL(Any status).
Outputs
countnumber- How many came back
ndcslist- Each NDC's details (one per source)
Example output
{
"count": 1,
"ndcs": [
{
"color": "WHITE",
"imprint": "PD;155;10",
"label_type": "HUMAN PRESCRIPTION DRUG",
"labeler": "Parke-Davis Div of Pfizer Inc",
"marketing_category": "NDA",
"marketing_status": "COMPLETED",
"ndc10": "0071-0155-23",
"ndc11": "00071015523",
"ndc9": "0071-0155",
"packaging": [
"90 TABLET, FILM COATED in 1 BOTTLE (0071-0155-23)"
],
"properties": [
{
"name": "LABELER",
"value": "Parke-Davis Div of Pfizer Inc"
}
],
"rxcui": "617314",
"shape": "elliptical",
"size": "10 mm",
"source": "Hybrid",
"spl_set_id": "c6e131fe-e7df-4876-83f7-9156fc4e8228"
}
]
}Get NDC status
Check a National Drug Code: whether it is active, obsolete or unknown to RxNorm, which drug it belongs to now, and which drugs it belonged to before.
Inputs
- NDC
ndctextRequired - The NDC: 11 digits, or with hyphens as on the label, e.g. 0071-0155-23.
Outputs
activetrue/false- Whether it is active
commenttext- RxNorm's note about it, if any
concept_nametext- That concept's name
concept_statustext- That concept's status, e.g. ACTIVE
historylist- The concepts it has belonged to
ndc11text- The NDC in 11-digit form
rxcuitext- The concept it belongs to now
rxnorm_ndctrue/false- Whether RxNorm itself lists it
sourceslist- The vocabularies that list the NDC
statustext- ACTIVE, OBSOLETE, ALIEN (only in other vocabularies) or UNKNOWN
summarytext- One line saying what was found
Example output
{
"active": true,
"comment": null,
"concept_name": "atorvastatin 10 MG Oral Tablet [Lipitor]",
"concept_status": "ACTIVE",
"history": [
{
"first_release": "2007-06",
"last_release": "2026-10",
"original_rxcui": "617314",
"rxcui": "617314"
}
],
"ndc11": "00071015523",
"rxcui": "617314",
"rxnorm_ndc": true,
"sources": [
"MMSL",
"RXNORM",
"VANDF"
],
"status": "ACTIVE",
"summary": "0071-0155-23: active, atorvastatin 10 MG Oral Tablet [Lipitor]"
}Get NDCs
Get the National Drug Codes (NDCs, the codes on U.S. drug packages) of a concept: the current ones, or every one ever linked to it with the RxNorm releases it was linked in.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Which NDCs
historytext - Current NDCs, or every NDC ever linked. Defaults to current.One of:
current(Current NDCs (default)),ever(Every NDC ever linked to it),ever_including_remapped(Every NDC ever linked, or inherited by remapping).
Outputs
countnumber- How many came back
ndcslist- The NDCs
rxcuitext- The RxCUI that was asked about
Example output
{
"count": 1,
"ndcs": [
{
"first_release": null,
"last_release": null,
"linked": "direct",
"ndc": "00071015523",
"rxcui": "617314"
}
],
"rxcui": "617314"
}Get related concepts
Get the concepts of chosen term types related to a concept, e.g. a branded drug's ingredient (IN), brand name (BN) and generic equivalent (SCD), or every branded drug (SBD) of an ingredient.
Inputs
- RxCUI
rxcuitextRequired - The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Term types
term_typeslistRequired - Which kinds of related concept to get, e.g. Ingredient and Clinical drug.One or more of:
IN(Ingredient (IN)),PIN(Precise ingredient (PIN)),MIN(Multiple ingredients (MIN)),BN(Brand name (BN)),SCD(Clinical drug (SCD)),SBD(Branded drug (SBD)),SCDC(Clinical drug component (SCDC)),SBDC(Branded drug component (SBDC)),SCDF(Clinical drug form (SCDF)),SBDF(Branded drug form (SBDF)), and 9 more.
Outputs
conceptslist- The related concepts
countnumber- How many came back
rxcuitext- The RxCUI that was asked about
summarytext- One line saying what was found
Example output
{
"concepts": [
{
"language": "ENG",
"name": "atorvastatin",
"rxcui": "83367",
"suppressed": false,
"synonym": null,
"term_type": "Ingredient",
"tty": "IN"
}
],
"count": 1,
"rxcui": "617314",
"summary": "1 related concept"
}Get spelling suggestions
Get the drug names RxNorm knows that are spelled like a misspelled one, e.g. 'ambien' for 'ambienn'.
Inputs
- Drug name
nametextRequired - The name as typed, e.g. ambienn.
Outputs
countnumber- How many came back
suggestionslist- Names spelled like it, closest first
Example output
{
"count": 1,
"suggestions": [
"ambien"
]
}List class types
List the kinds of drug class RxClass has (ATC classes, pharmacologic classes, mechanisms of action, diseases...), each with the source that defines it.
Inputs
None.
Outputs
class_typeslist- The kinds of class
countnumber- How many came back
Example output
{
"class_types": [
{
"class_type": "EPC",
"default_rela_source": "DAILYMED",
"name": "Established pharmacologic class"
}
],
"count": 1
}