APIs

RxNorm API

findRelatedNDCs

Information returned
NDCs related by NDC product, RxNorm concept, or RxNorm drug product
Service domain
https://rxnav.nlm.nih.gov
HTTP request
GET  /REST/relatedndc.xml?ndc=NDC&relation=R&ndcstatus=S

Description

Get NDCs that are related by concept, drug, or NDC product.

Concept
NDCs associated with the same RxNorm concept as the subject NDC. For example, if NDC 0781-5384-92 is mapped to atorvastatin 40 MG Oral Tablet, then NDCs mapped to this concept will be returned.
Drug
NDCs associated with any drug concept (SBD, SCD, BPCK, or GPCK) that is related to the RxNorm concept of the subject NDC. For example, if NDC 0781-5384-92 is mapped to atorvastatin 40 MG Oral Tablet, then the NDCs mapped to this concept or to the related branded product Lipitor 40 MG Oral Tablet will be returned.
Product
NDCs having the same initial two-segment code as the subject NDC. Use this to find packagings of a manufacturer's product. For example, return all NDCs for product code 0071-0157.

The ndcstatus parameter can filter the results, returning only NDCs of specified status.

NDC status values:
ACTIVE
The NDC is recognized by RxNorm as active and is associated with an active concept. The RxCUI associated with the NDC is contained in the returned history data.
OBSOLETE
The NDC previously existed in RxNorm, but is no longer recognized as active. The history data will indicate the time periods and RxCUI(s) associated with the NDC.
ALIEN
The NDC is or was contained only in a source vocabulary other than RxNorm. This status means that the NDC has never been active in RxNorm.
UNKNOWN
The NDC is unknown or invalid. This means that the NDC has never been active in RxNorm, is not in a source vocabulary other than RxNorm, and no history data is available.

Scope

Active: concepts in the current RxNorm data set that have an atom with SAB=RXNORM and SUPPRESS=N

Parameters

ParameterLocationUseDescriptionDefault
formatPathOptional

Notation for results

One of:
.xml
Get results in XML
.json
Get results in JSON
.xml
ndcQueryRequiredNDC (CMS 11-digit, or three-segment 5-3-2, 5-4-1, or 4-4-2, or two-segment 4-4, 5-3, or 5-4; no asterisks)
relationQueryRequiredGroup of NDCs to retrieve
One of:
concept
NDCs of the same RxNorm concept
product
NDCs of the same NDC product
drug
NDCs of the same RxNorm active drug
ndcstatusQueryOptionalStatus filter for NDCs to retrieve
One or more of:
active
Linked by RXNORM to an active concept
obsolete
Previously linked by RXNORM
alien
Found only in a non-RXNORM vocabulary
ALL
Any status

(Space-separated list.)

active

All query parameters are case-insensitive.

Note that HTTP requires that query parameters be "URL encoded". For instance, a "space-separated list" will, in practice, usually appear to use either a plus sign (+) or %20 as the separator. For full information on URL encoding, please refer to IETF RFC 3986, "Uniform Resource Identifier".

Output structure

Results are available as either XML or JSON.

  • The XML result has the root element rxnormdata. It is described in the XML Schema for the RxNorm API; the relevant element structure is summarized below. Elements that would be empty might be left out.

  • The JSON result is an object {...}, analogous to the content of the XML rxnormdata. Fields that might occur multiple times in the XML are expressed as an array. Fields that would be empty might be null or left out. Numbers are expressed as strings.

Both XML and JSON results follow the same outline:

rxnormdata
Root element in XML, or anonymous object in JSON
ndcInfoList
ndcInfo (array)
ndc11
National Drug Code (NDC) in CMS 11-digit format
status
NDC status
rxcui
RxNorm identifier
conceptName
A name for the concept
conceptStatus
RxNorm concept status
tty
RxNorm Term type

Example: Active NDCs that are packagings of a given NDC two-segment code

XML: https://rxnav.nlm.nih.gov/REST/relatedndc?relation=product&ndc=0069-3060

JSON: https://rxnav.nlm.nih.gov/REST/relatedndc.json?relation=product&ndc=0069-3060

An XML result is shown below.

<rxnormdata>
    <ndcInfoList>
        <ndcInfo>
            <ndc11>00069306030</ndc11>
            <status>ACTIVE</status>
            <rxcui>212446</rxcui>
            <conceptName>azithromycin 250 MG Oral Tablet [Zithromax]</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SBD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00069306075</ndc11>
            <status>ACTIVE</status>
            <rxcui>750149</rxcui>
            <conceptName>{6 (azithromycin 250 MG Oral Tablet [Zithromax]) } Pack [Z-PAK]</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>BPCK</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00069306086</ndc11>
            <status>ACTIVE</status>
            <rxcui>212446</rxcui>
            <conceptName>azithromycin 250 MG Oral Tablet [Zithromax]</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SBD</tty>
        </ndcInfo>
    </ndcInfoList>
</rxnormdata>

Example: NDCs, active or not, related to a drug

XML: https://rxnav.nlm.nih.gov/REST/relatedndc?ndc=0015-7403-20&relation=drug&ndcstatus=all

JSON: https://rxnav.nlm.nih.gov/REST/relatedndc.json?ndc=0015-7403-20&relation=drug&ndcstatus=all

An XML result is shown below.

<rxnormdata>
    <ndcInfoList>
        <ndcInfo>
            <ndc11>00003291810</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00003291820</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00015740318</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00015740320</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00015740399</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00404981799</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00409268301</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00409268311</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00409371801</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00409371810</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00615012101</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00641225241</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781340778</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781340795</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781925078</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781925095</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781940778</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>00781940795</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>10515014600</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>25021013510</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>36000007110</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>39822040005</ndc11>
            <status>ALIEN</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>43858011278</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>43858011295</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>44567010110</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>52584007110</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>52584013510</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>52584035050</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>54569153000</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>54868404700</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>55150011210</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>63323038810</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>63323070800</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>65219001601</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>65219001610</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>66794022102</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>66794022141</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>67457035010</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>67457035050</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>67850002400</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>67850002410</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>70594008501</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>70594008502</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>70860011315</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>70860011341</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>76126002710</ndc11>
            <status>OBSOLETE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
        <ndcInfo>
            <ndc11>82449090310</ndc11>
            <status>ACTIVE</status>
            <rxcui>1721474</rxcui>
            <conceptName>ampicillin 500 MG Injection</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
    </ndcInfoList>
</rxnormdata>

Example: Active NDCs related to the same RxNorm concept

XML: https://rxnav.nlm.nih.gov/REST/relatedndc?ndc=72887064812&relation=concept

JSON: https://rxnav.nlm.nih.gov/REST/relatedndc.json?ndc=72887064812&relation=concept

An XML result is shown below.

<rxnormdata>
    <ndcInfoList>
        <ndcInfo>
            <ndc11>72887064812</ndc11>
            <status>ACTIVE</status>
            <rxcui>2105822</rxcui>
            <conceptName>acetaminophen 60 MG/ML / oxycodone hydrochloride 2 MG/ML Oral Solution</conceptName>
            <conceptStatus>ACTIVE</conceptStatus>
            <tty>SCD</tty>
        </ndcInfo>
    </ndcInfoList>
</rxnormdata>