RxClass Members¶
Retrieves the drug members of a specified RxClass and returns both a full JSON payload and convenient lists of member RxCUIs and names. It queries the RxNorm RxClass service for the given class ID and classification system, and formats results for downstream processing.
Usage¶
Use this node when you have an RxClass identifier and want to enumerate the drugs that belong to that class. It fits into workflows where you first search or look up a class (e.g., via RxClass Search or RxClass Information), then pass the class ID here to obtain the member drugs for analysis, filtering, or display.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| class_id | True | STRING | The RxClass identifier whose drug members you want to retrieve. | 100 |
| class_system | True | CHOICE | The drug class system/source relation to query. Must be a valid value supported by the RxNorm API (e.g., ATC). | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| class_members | STRING | A JSON string containing the full response for the class members, including the original class_id and returned data. | {"class_id":"100","data":{...}} |
| members_rxcui | STRING | A JSON array (as a string) of RxCUIs for the member drugs extracted from the response. | ["153839","1234","5678"] |
| members_name | STRING | A JSON array (as a string) of drug names corresponding to the member RxCUIs. | ["lisinopril","enalapril","captopril"] |
| status | STRING | A human-readable status message indicating success or error. | Successfully retrieved RxClass members for class ID 100 |
Important Notes¶
- Input validation: The class_id must not be empty; otherwise the node returns empty arrays and an error status.
- Class system values: class_system must be a valid source relation supported by the RxNorm API. Using an unsupported value may return an API error.
- Output formats: members_rxcui and members_name are JSON arrays serialized as strings for compatibility. Parse them back to arrays if you need to iterate.
- Empty results: If a class has no members or the response lacks a drugMemberGroup, the members arrays will be empty.
- Error propagation: If the underlying API returns an error, the class_members output contains the error JSON and the status starts with "API Error:".
Troubleshooting¶
- Error: Class ID cannot be empty: Provide a non-empty class_id obtained from a prior class search or info lookup.
- API Error in status: Verify the class_id and class_system are correct and supported. Retry if the RxNorm service is temporarily unavailable.
- Empty members arrays: The class may legitimately have no members for the selected system. Try a different class_system or confirm the class ID is correct.
- Unexpected output parsing: Remember members_rxcui and members_name are JSON strings. Parse them before use in tools expecting arrays.