RxTerms Information¶
Retrieves RxTerms metadata for one or more RxNorm Concept Unique Identifiers (RXCUIs). It returns the full RxTerms response and key extracted fields (full name, strength, route, and dose forms) as JSON strings. Supports single RXCUI or a JSON array of RXCUIs in one request.
Usage¶
Use this node when you need standardized RxTerms information for medications identified by RxCUI(s). Typical workflow: provide an RXCUI (or a JSON array of RXCUIs) from an upstream lookup, then route the outputs to downstream nodes that parse or display drug full names, strengths, routes, and dose forms.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| rxcui | True | STRING | An RxNorm Concept Unique Identifier. Accepts either a single RXCUI (e.g., "313") or a JSON array string of RXCUIs (e.g., "[\"313\", \"1049630\"]"). | 313 |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| rxterms_info | STRING | JSON string mapping each input RXCUI to the full RxTerms response object. | { "313": { "rxtermsProperties": { "fullName": "Aspirin 325 MG Oral Tablet", "strength": "325 MG", "route": "Oral", "rxnormDoseForm": "Oral Tablet" } } } |
| full_name | STRING | JSON string mapping each RXCUI to its RxTerms full name. | { "313": "Aspirin 325 MG Oral Tablet" } |
| strength | STRING | JSON string mapping each RXCUI to the strength value from RxTerms. | { "313": "325 MG" } |
| route | STRING | JSON string mapping each RXCUI to the route of administration. | { "313": "Oral" } |
| forms | STRING | JSON string mapping each RXCUI to the RxNorm dose form. | { "313": "Oral Tablet" } |
Important Notes¶
- All outputs are JSON strings. Parse them downstream if you need structured access.
- Input can be either a single RXCUI or a JSON array string of RXCUIs (e.g., "[\"313\", \"1049630\"]").
- On lookup errors or invalid inputs, the node returns empty objects ("{}") for affected entries and does not raise an exception.
- Whitespace-only RXCUI entries are treated as errors and yield empty values.
- This node relies on an external RxNorm/RxTerms service via an internal API helper; availability and response quality depend on that service.
Troubleshooting¶
- If all outputs are "{}": verify the RXCUI value is valid and correctly formatted.
- If using multiple RXCUIs, ensure the input is a valid JSON array string (e.g., "[\"313\", \"1049630\"]").
- If specific RXCUIs are missing in outputs: they may be invalid or the service returned an error for those entries.
- If network or service issues occur, retry later; intermittent failures result in empty outputs.
- If you expect numbers but provided them without quotes in the JSON array, ensure they are valid JSON (numbers are allowed, but strings are recommended to preserve formatting).