RxNorm API - APIs
APIs
APIs
RxNorm API
The RxNorm API is a web service for accessing information from the RxNorm data set.
This API documentation assumes familiarity with the
RxNorm documentation
Each function covers RxNorm Concepts within a certain scope. The scopes are:
Active
concepts in the current RxNorm data set that have an atom with SAB=RXNORM and SUPPRESS=N
Current
concepts in the current RxNorm data set that have an atom with SUPPRESS=N
Current and Historical
concepts in current and previous RxNorm data sets
Use of the API is subject to
With one exception, no license is needed to use the RxNorm API. This is because the data returned from the API is from the RxNorm vocabulary, a non-proprietary vocabulary developed by the National Library of Medicine.
Functions
Function
REST Resource
Description
Scope
filterByProperty
/rxcui/
rxcui
/filter
Concept RXCUI if the predicate is true
Active
findActiveProducts
/rxcui/
rxcui
/active
Active product(s) approximately corresponding to a possibly-archived or -obsolete product
Current and Historical
findRelatedNDCs
/relatedndc
NDCs related by NDC product, RxNorm concept, or RxNorm drug product
Active
findRxcuiById
/rxcui?
idtype
...
id
...
Concepts associated with a specified identifier
Active or Current
findRxcuiByString
/rxcui?
name
...
Concepts with a specified name
Active or Current
getAllConceptsByStatus
/allstatus
Concepts having a specified status
Current and Historical
getAllConceptsByTTY
/allconcepts
Concepts having a specified term type
Active
getAllHistoricalNDCs
/rxcui/
rxcui
/allhistoricalndcs
National Drug Codes (NDC) ever associated with a concept
Current and Historical
getAllNDCsByStatus
/allNDCstatus
NDCs having a specified NDC status
Current and Historical
getAllProperties
/rxcui/
rxcui
/allProperties
Concept details
Active
getAllRelatedInfo
/rxcui/
rxcui
/allrelated
Concepts related directly or indirectly to a specified concept
Active
getApproximateMatch
/approximateTerm
Concept and atom IDs approximately matching a query
Active or Current
getDisplayTerms
/displaynames
Strings to support auto-completion in a user interface
Active
getDrugs
/drugs
Drugs related to a specified name
Active
getGenericProduct
/rxcui/
rxcui
/generic
Unbranded RxCUI corresponding to a possibly branded product RxCUI
Active
getIdTypes
/idtypes
Identifier types
Current
getMultiIngredBrand
/brands
Brands containing specified ingredients
Active
getNDCProperties
/ndcproperties
National Drug Code (NDC) details
Current and Historical
getNDCStatus
/ndcstatus
Status of a National Drug Code (NDC)
Current and Historical
getNDCs
/rxcui/
rxcui
/ndcs
National Drug Codes (NDC) associated with a concept
Active
getPropCategories
/propCategories
RxNav property categories
Active
getPropNames
/propnames
Property names
Active
getProprietaryInformation
/rxcui/
rxcui
/proprietary
Strings from any RXNORM source vocabularies
Current
getReformulationConcepts
/reformulationConcepts
Concepts related by reformulation_of
Active
getRelaPaths
/relapaths
Relationship paths leading from one term-type to another
Active
getRelaTypes
/relatypes
RxNorm Relationship types
Active
getRelatedByRelationship
/rxcui/
rxcui
/related?
rela
...
Concepts directly related to a specified concept by a specified relationship
Active
getRelatedByType
/rxcui/
rxcui
/related?
tty
...
Concepts of specified types that are directly or indirectly related to a specified concept
Active
getRxConceptProperties
/rxcui/
rxcui
/properties
Concept name, TTY, and a synonym
Active
getRxNormName
/rxcui/
rxcui
Name of a concept
Active
getRxNormVersion
/version
RxNorm data set and API versions
Current
getRxProperty
/rxcui/
rxcui
/property
A property of a concept
Active
getRxcuiHistoryStatus
/rxcui/
rxcui
/historystatus
Status, history, and other attributes of a concept
Current and Historical
getSourceTypes
/sourcetypes
Vocabulary sources
Current
getSpellingSuggestions
/spellingsuggestions
Strings similar to a specified string
Active
getTermTypes
/termtypes
Term types
Active