RxNorm Drugs by Class¶
Retrieves the list of RxNorm drug members for a given drug class ID, constrained by a selected relationship source (e.g., ATC, MEDRT). Returns a JSON string with the original API data bundled alongside your inputs and a status message. Useful for enumerating drugs associated with a therapeutic or classification class.
Usage¶
Use this node when you have a drug class identifier and want to obtain all RxNorm drug members linked to that class from a specific source system. Typical workflow: look up or select a class ID, choose the relationship source that defines the class membership (such as ATC), then pass the output JSON to downstream nodes for filtering, reporting, or further analysis.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| class_id | True | STRING | The identifier of the drug class to query. Must be a valid class ID known to the chosen relationship source. | D007398 |
| relationship_source | True | ATC \| ATCPROD \| CDC \| DAILYMED \| FDASPL \| FMTSME \| MEDRT \| RXNORM \| SNOMEDCT \| VA | Selects the source system that defines the class-to-drug relationships. This determines which set of drug members are returned for the given class ID. | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| drug_members | STRING | A JSON string containing the query context and results: { "class_id": ..., "relationship_source": ..., "drug_members": | { "class_id": "D007398", "relationship_source": "ATC", "drug_members": { "drugMemberGroup": { "drugMember": [ { "minConcept": { "rxcui": "...", "name": "..." } } ] } } } |
| status | STRING | Human-readable status message indicating success or describing an error. | Successfully retrieved drug members for class ID D007398 with relationship source ATC |
Important Notes¶
- Input validation: The node returns an error status if class_id is empty.
- Source sensitivity: Results depend on the chosen relationship_source; a class_id may be valid in one source and not in another.
- Output format: The first output is a JSON string, not a parsed object. Downstream steps should parse it before structured use.
- API passthrough: If the underlying service reports an error, it is returned as a JSON string in the first output with an 'API Error' status.
- Result size: Some classes can return many members, which may produce large JSON outputs.
- Defaults: Default class_id is "D007398" and default relationship_source is "ATC".
Troubleshooting¶
- Empty or invalid class_id: Ensure class_id is not blank and matches a valid identifier in the selected relationship_source.
- No results returned: Try a different relationship_source or verify that the class exists within that source.
- Unexpected JSON structure: The raw API response is embedded under 'drug_members'; check for keys like 'drugMemberGroup' and 'drugMember'.
- Downstream parsing errors: Confirm that you are parsing the first output as JSON text before extracting fields.
- API Error status: Inspect the first output JSON for an 'error' field; correct the inputs or try again later if the service is temporarily unavailable.