# RxNorm

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/rxnorm

## Actions

### 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 (`term`, text, required): What to match, e.g. zocor 10 mg.
- How many names (`max_entries`, number): 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_only`, true/false): On by default. Turn off to also match drugs only other drug vocabularies name.

**Outputs**

- `count` (number): How many came back
- `matches` (list): The closest drugs, best first

**Example output**

```json
{
  "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_rxcuis`, list, required): The RxCUIs of the ingredients, e.g. 20610 (cetirizine) and 8896 (pseudoephedrine).

**Outputs**

- `brands` (list): The brand names (term type BN)
- `count` (number): How many came back

**Example output**

```json
{
  "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_type`, text, required): Which vocabulary the code is from, e.g. NDC or ATC.
- Code (`code`, text, required): The code, e.g. C10AA05 (ATC) or 00071015523 (NDC).

**Outputs**

- `concepts` (list): The concepts the code stands for
- `count` (number): How many came back
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`name`, text, required): The drug's name, e.g. Lipitor 10 MG Oral Tablet or atorvastatin.
- Match (`match`, text): 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**

- `concepts` (list): The concepts found
- `count` (number): How many came back
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`name`, text, required): The name, or words in it, e.g. HMG CoA reductase inhibitors.
- Match (`match`, text): 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_types`, list): Only classes of these kinds, e.g. EPC. Leave empty for all.
- At most (`limit`, number): How many classes to return, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `classes` (list): The classes found
- `count` (number): How many came back
- `total_found` (number): How many matched, before 'At most' was applied

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.

**Outputs**

- `concepts` (list): The related concepts, by term type
- `count` (number): How many came back
- `rxcui` (text): The RxCUI that was asked about
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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_id`, text, required): The class's id, e.g. C10AA. 'Find drug classes' gives it.
- Kind of class (`class_type`, text): The class's kind, e.g. DISEASE, when its id is used by more than one kind.

**Outputs**

- `ancestors` (list): The classes above it
- `count` (number): How many came back
- `edges` (list): Each class's link to its parent
- `requested_class` (object): The class asked about

**Example output**

```json
{
  "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_id`, text, required): The class's id, e.g. C10AA. 'Find drug classes' gives it.
- Relationship source (`rela_source`, text): Whose links to use, e.g. ATC or MEDRT. Leave empty for the class's own.
- Relationship (`rela`, text): Only this kind of link, e.g. may_treat or has_epc.
- Term types (`term_types`, list): 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_indirect`, true/false): Also list drugs that belong through a class under this one.

**Outputs**

- `class_id` (text): The class asked about
- `count` (number): How many came back
- `members` (list): The drugs in the class
- `rela_source` (text): The relationship source used

**Example output**

```json
{
  "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_id`, text, required): The class's id, e.g. C10AA. 'Find drug classes' gives it.

**Outputs**

- `count` (number): How many came back
- `descendants` (list): Every class under it, depth first
- `requested_class` (object): The class asked about

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.

**Outputs**

- `concept` (object): An RxNorm concept
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.

**Outputs**

- `active_from` (text): When it became active (YYYY-MM)
- `active_until` (text): When it stopped being active (YYYY-MM)
- `dose_form_groups` (list): Its dose form groups, e.g. Pill
- `dose_forms` (list): Its dose forms, e.g. Oral Tablet
- `first_release` (text): The first RxNorm release it was in (YYYY-MM)
- `ingredients` (list): Its ingredients and strengths
- `is_branded` (true/false): Whether it is a branded drug
- `is_current` (true/false): Whether it is in the current RxNorm release
- `is_multiple_ingredient` (true/false): Whether it has several ingredients
- `last_release` (text): The last release it was in, if it has left (YYYY-MM)
- `name` (text): The concept's name
- `remapped_on` (text): When it was remapped (YYYY-MM)
- `remapped_to` (list): The concepts it was remapped to
- `rxcui` (text): The RxCUI that was asked about
- `source` (text): The vocabulary it comes from, e.g. RXNORM
- `status` (text): Active, Obsolete, Remapped, Quantified, NotCurrent...
- `summary` (text): One line saying what was found
- `tty` (text): Its term type code

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Kinds of property (`categories`, list): 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**

- `count` (number): How many came back
- `properties` (list): The properties
- `rxcui` (text): The RxCUI that was asked about

**Example output**

```json
{
  "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_name`, text): The drug, e.g. atorvastatin. Give this or the RxCUI.
- RxCUI (`rxcui`, text): The drug's RxCUI, e.g. 83367. Used instead of the name when given.
- Relationship source (`rela_source`, text): Only links from this source, e.g. ATC, DAILYMED or MEDRT.
- Relationship (`rela`, text): Only this kind of link, e.g. may_treat or has_epc.

**Outputs**

- `classes` (list): The classes
- `count` (number): How many came back

**Example output**

```json
{
  "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 (`name`, text, required): e.g. cetirizine, Zyrtec or cetirizine 10 MG Oral Tablet.

**Outputs**

- `count` (number): How many came back
- `products` (list): The drug products
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`identifier`, text, required): An NDC (e.g. 0071-0155-23), an RxCUI for all of a drug's NDCs, or an FDA label set id.
- NDC status (`status`, list): 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**

- `count` (number): How many came back
- `ndcs` (list): Each NDC's details (one per source)

**Example output**

```json
{
  "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 (`ndc`, text, required): The NDC: 11 digits, or with hyphens as on the label, e.g. 0071-0155-23.

**Outputs**

- `active` (true/false): Whether it is active
- `comment` (text): RxNorm's note about it, if any
- `concept_name` (text): That concept's name
- `concept_status` (text): That concept's status, e.g. ACTIVE
- `history` (list): The concepts it has belonged to
- `ndc11` (text): The NDC in 11-digit form
- `rxcui` (text): The concept it belongs to now
- `rxnorm_ndc` (true/false): Whether RxNorm itself lists it
- `sources` (list): The vocabularies that list the NDC
- `status` (text): ACTIVE, OBSOLETE, ALIEN (only in other vocabularies) or UNKNOWN
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Which NDCs (`history`, text): 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**

- `count` (number): How many came back
- `ndcs` (list): The NDCs
- `rxcui` (text): The RxCUI that was asked about

**Example output**

```json
{
  "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 (`rxcui`, text, required): The concept's RxCUI, the number RxNorm identifies a drug by, e.g. 617314. 'Find concepts by name' gives it.
- Term types (`term_types`, list, required): 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**

- `concepts` (list): The related concepts
- `count` (number): How many came back
- `rxcui` (text): The RxCUI that was asked about
- `summary` (text): One line saying what was found

**Example output**

```json
{
  "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 (`name`, text, required): The name as typed, e.g. ambienn.

**Outputs**

- `count` (number): How many came back
- `suggestions` (list): Names spelled like it, closest first

**Example output**

```json
{
  "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_types` (list): The kinds of class
- `count` (number): How many came back

**Example output**

```json
{
  "class_types": [
    {
      "class_type": "EPC",
      "default_rela_source": "DAILYMED",
      "name": "Established pharmacologic class"
    }
  ],
  "count": 1
}
```
