RxClass Members¶
Retrieves the drug members for a given RxClass identifier within a specified classification system. Returns the full API payload as JSON plus pre-extracted arrays of member RxCUIs and names for easy downstream use.
Usage¶
Use this node when you have an RxClass ID and need the list of drugs that belong to that class (e.g., all drugs under an ATC class). Typically, you select the classification system (such as ATC) that the class ID belongs to, run the node to fetch members, and then pass the extracted RxCUIs or names into further analysis or filtering steps.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| class_id | True | STRING | The RxClass identifier to query. This should be a valid class ID corresponding to the chosen classification system. | 100 |
| class_system | True | SELECT | The classification system/source to use when looking up members. Must be one of the supported RxNorm drug class source relations. Choose the system that your class_id belongs to. | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| class_members | STRING | JSON string containing the full response for the class members, including the original class_id and data returned by the service. | {"class_id": "100", "data": {"drugMemberGroup": {"drugMember": [...]}}} |
| members_rxcui | STRING | JSON-encoded array of RxCUIs extracted from the class member list. | ["83367", "617314", "617318"] |
| members_name | STRING | JSON-encoded array of drug names extracted from the class member list. | ["Lisinopril", "Enalapril", "Captopril"] |
| status | STRING | Human-readable status message indicating success or describing any error encountered. | Successfully retrieved RxClass members for class ID 100 |
Important Notes¶
- Input matching: Ensure the class_id actually belongs to the selected class_system; mismatches can yield empty results or errors.
- Output formats: The members_rxcui and members_name outputs are JSON-encoded arrays (strings). Parse them if you need native array types.
- Empty handling: If no members are found or inputs are invalid, the node returns "[]" for the arrays and a descriptive status.
- System options: The class_system dropdown is populated from the platform's supported RxNorm drug class source relations; ATC is the default.
- Data volume: Some classes may have many members, leading to large JSON payloads in class_members.
Troubleshooting¶
- No results or empty arrays: Verify the class_id is correct for the chosen class_system and that the class actually has members.
- API Error in status: The status will include the error returned by the upstream service. Retry later or adjust inputs.
- Invalid class_id: An empty or malformed class_id will produce an error status and empty outputs. Provide a non-empty, valid identifier.
- Unexpected output format: Remember that members_rxcui and members_name are JSON strings; parse them before list operations.