RxNorm Drugs by Class¶
Retrieves the list of RxNorm drug members associated with a specified drug class. You provide a class identifier and a relationship source (e.g., ATC, MEDRT), and the node returns a JSON string with the drugs linked to that class and a status message. It validates inputs and surfaces API errors in the output.
Usage¶
Use this node when you need to enumerate RxNorm drugs belonging to a particular pharmacologic or therapeutic class. Typical workflow: obtain or select a class ID (e.g., from a class search or external catalog), choose the relationship source system (e.g., ATC), then pass both to this node to get drug members as JSON for downstream analysis or visualization.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| class_id | True | STRING | Identifier of the drug class to query. Accepts IDs from supported classification systems; example default corresponds to a MeSH/ATC-style class code. | D007398 |
| relationship_source | True | STRING (one of: ATC, ATCPROD, CDC, DAILYMED, FDASPL, FMTSME, MEDRT, RXNORM, SNOMEDCT, VA) | Classification system source to use when retrieving members. Determines which relationship set is used to link drugs to the class. | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| drug_members | STRING | JSON string containing the request context and the retrieved drug members. Structure includes class_id, relationship_source, and the raw API results under drug_members. | {"class_id":"D007398","relationship_source":"ATC","drug_members":{...}} |
| status | STRING | Human-readable status of the operation. Contains success confirmation or an error message if validation or API calls fail. | Successfully retrieved drug members for class ID D007398 with relationship source ATC |
Important Notes¶
- This node returns JSON as a STRING; downstream nodes may need to parse it.
- class_id must be non-empty; an empty value returns an error status and an empty JSON object.
- relationship_source must be one of the allowed values: ATC, ATCPROD, CDC, DAILYMED, FDASPL, FMTSME, MEDRT, RXNORM, SNOMEDCT, VA.
- Results reflect the selected relationship source and may differ across systems.
- Network/API availability and rate limits can affect responses; API errors are returned in the drug_members JSON and summarized in the status string.
Troubleshooting¶
- If status reports 'Error: Class ID cannot be empty', provide a valid class_id string.
- If status contains 'API Error: ...', verify the class_id/source combination is valid and retry after checking network connectivity or API limits.
- If drug_members is an empty list or missing expected members, try a different relationship_source or confirm the class_id corresponds to that system.
- If downstream parsing fails, ensure you JSON-parse the drug_members output before accessing fields.