RxNorm API
getReformulationConcepts
- Information returned
- Concepts related by reformulation_of
- Service domain
- https://rxnav.nlm.nih.gov
- HTTP request
- GETÂ /REST/reformulationConcepts.xml
Description
Gets pairs of active RxNorm concepts related by "reformulation_of".
Scope
Active: concepts in the current RxNorm data set that have an atom with SAB=RXNORM and SUPPRESS=N
Parameters
Parameter | Location | Use | Description | Default |
---|---|---|---|---|
format | Path | Optional | Notation for results One of:
| .xml |
Note that HTTP requires that query parameters be "URL encoded". 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
- reformulationConceptList
- pairs of original and reformulated concepts
- reformulationConcept (array)
- original concept and corresponding concept with new formula
- rxcui
- original RXCUI
- reformulatedRxcui
- RXCUI of new formula
- name
- original concept's name
- reformulatedName
- name of concept with new formula
Example: Reformulated concepts
XML: https://rxnav.nlm.nih.gov/REST/reformulationConcepts
JSON: https://rxnav.nlm.nih.gov/REST/reformulationConcepts.json
An XML result is shown below.
<rxnormdata> <reformulationConceptList> <reformulationConcept> <rxcui>1053155</rxcui> <reformulatedRxcui>2589792</reformulatedRxcui> <name>Baza-Protect</name> <reformulatedName>Baza-Protect Reformulated June 2020</reformulatedName> </reformulationConcept> <reformulationConcept> <rxcui>152523</rxcui> <reformulatedRxcui>2607010</reformulatedRxcui> <name>Zantac</name> <reformulatedName>Zantac Reformulated Aug 2022</reformulatedName> </reformulationConcept> <reformulationConcept> <rxcui>217219</rxcui> <reformulatedRxcui>2120575</reformulatedRxcui> <name>Fungi-Nail</name> <reformulatedName>Fungi-Nail Reformulated Mar 2019</reformulatedName> </reformulationConcept> <reformulationConcept> <rxcui>218181</rxcui> <reformulatedRxcui>2600783</reformulatedRxcui> <name>Magonate</name> <reformulatedName>Magonate Reformulated May 2022</reformulatedName> </reformulationConcept> <reformulationConcept> <rxcui>794924</rxcui> <reformulatedRxcui>2174797</reformulatedRxcui> <name>Calagel</name> <reformulatedName>Calagel Reformulated Jun 2019</reformulatedName> </reformulationConcept> </reformulationConceptList> </rxnormdata>