APIs

Prescribable RxNorm API

getAllProperties

Information returned
Concept details
Service domain
https://rxnav.nlm.nih.gov
HTTP request
GET  /REST/Prescribe/rxcui/rxcui/allProperties.xml?prop=yourPropCategories

Description

Return certain categories of properties for the RxNorm concept specified by rxcui. Information returned includes property name, value and category. The prop parameter selects the categories of properties to retrieve.

The following table shows each property, its category, the RxNorm file where it resides, and other details. Note that only the properties that exist for the concept will be returned. The RxNorm technical documentation contains more details on RxNorm properties.

PropertyCategoryRxNorm fileDetails
ACTIVATEDATTRIBUTESRXNSATATN='RXN_ACTIVATED'
ANADACODESRXNSATATN='ANADA'
ANDACODESRXNSATATN='ANDA'
AVAILABLE_STRENGTHATTRIBUTESRXNSATATN='RXN_AVAILABLE_STRENGTH'
BLACODESRXNSATATN='BLA'
BN_CARDINALITYATTRIBUTESRXNSATATN='RXN_BN_CARDINALITY'
GENERAL_CARDINALITYATTRIBUTESRXNCONSO

SINGLE, MULTI or HYBRID, according to the term type and the number of ingredients as reflected by the presence of a related TTY=MIN (multiple ingredient) concept:

Term type (TTY)With related TTY=MINWithout related TTY=MIN
INSINGLE
PINSINGLE
MINMULTI
SCDCHYBRIDSINGLE
otherMULTISINGLE
HUMAN_DRUGATTRIBUTESRXNSATATN='RXN_HUMAN_DRUG'
IN_EXPRESSED_FLAGATTRIBUTESRXNSATATN='RXN_IN_EXPRESSED_FLAG'
NADACODESRXNSATATN='NADA'
NDACODESRXNSATATN='NDA'
NHRICCODESRXNSATATN='NHRIC'
ORIG_CODECODESRXNSATATN='orig_code'
ORIG_SOURCESOURCESRXNSATATN='orig_source'
PRESCRIBABLEATTRIBUTESRXNCONSO'Y' when CVF=4096
Prescribable SynonymNAMESRXNCONSOSTR field when TTY='PSN'
QUALITATIVE_DISTINCTIONATTRIBUTESRXNSATATN='RXN_QUALITATIVE_DISTINCTION'
QUANTITYATTRIBUTESRXNSATATN='RXN_QUANTITY'
RxCUICODESRXNCONSORXCUI field
RXNAV_HUMAN_DRUGATTRIBUTESRXNSATDerived from RXN_HUMAN_DRUG attribute: "US" when there is a related SCD or SBD with RXN_HUMAN_DRUG="US", otherwise empty. This property does not apply to drug packs (term types GPCK or BPCK). For drug packs, refer to property HUMAN_DRUG.
RXNAV_STRNAMESRXNCONSOConcept name (or, for SBD or BPCK, a shortest SY synonym); in Tallman capitalization where available
RXNAV_VET_DRUGATTRIBUTESRXNSATDerived from RXN_VET_DRUG attribute: "US" when there is a related SCD or SBD with RXN_VET_DRUG="US", otherwise empty
RxNorm NameNAMESRXNCONSOSTR field when SAB='RXNORM'
RxNorm SynonymNAMESRXNCONSOShortest length STR field for TTY='SY'
SPL_SET_IDCODESRXNSATATN='SPL_SET_ID'
STRENGTHATTRIBUTESRXNSATATN='RXN_STRENGTH'
SourceSOURCESRXNCONSODerived from SAB field (non-RXNORM sources)
TTYATTRIBUTESRXNCONSOTTY field
Tallman SynonymNAMESRXNCONSOSTR field when TTY='TMSY'
UNII_CODECODESRXNCONSOCODE field when SAB='MTHSPL' and TTY='SU'
VET_DRUGATTRIBUTESRXNSATATN='RXN_VET_DRUG'

Scope

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

Parameters

ParameterLocationUseDescriptionDefault
rxcuiPathRequiredRxNorm identifier
formatPathOptional

Notation for results

One of:
.xml
Get results in XML
.json
Get results in JSON
.xml
propQueryRequiredProperty categories to retrieve, or ALL

(Space-separated list. See getPropCategories for the menu.)

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 Prescribable 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
propConceptGroup
Collection of properties
propConcept (array)
One property name and value. Repeated for additional values
propCategory
RxNav category that includes the property
propName
Property name
propValue
Value of the property

Example: 'Attributes' properties of acetaminophen (RxCUI=161)

XML: https://rxnav.nlm.nih.gov/REST/Prescribe/rxcui/161/allProperties?prop=attributes

JSON: https://rxnav.nlm.nih.gov/REST/Prescribe/rxcui/161/allProperties.json?prop=attributes

An XML result is shown below.

<rxnormdata>
    <propConceptGroup>
        <propConcept>
            <propCategory>ATTRIBUTES</propCategory>
            <propName>GENERAL_CARDINALITY</propName>
            <propValue>SINGLE</propValue>
        </propConcept>
        <propConcept>
            <propCategory>ATTRIBUTES</propCategory>
            <propName>PRESCRIBABLE</propName>
            <propValue>Y</propValue>
        </propConcept>
        <propConcept>
            <propCategory>ATTRIBUTES</propCategory>
            <propName>RXNAV_HUMAN_DRUG</propName>
            <propValue>US</propValue>
        </propConcept>
        <propConcept>
            <propCategory>ATTRIBUTES</propCategory>
            <propName>TTY</propName>
            <propValue>IN</propValue>
        </propConcept>
    </propConceptGroup>
</rxnormdata>