RxNorm Concept Info¶
Retrieves detailed information for a specific RxNorm concept. You provide a JSON string of RxCUI(s), choose one by index, and select the type of information to fetch (name, NDCs, concept properties, or all related info). Returns a formatted JSON payload with the requested data, the selected RxCUI, and a status message.
Usage¶
Use this node after obtaining a list of RxCUIs from a prior step (e.g., a drug search). Pass the RxCUIs as a JSON string array, select which RxCUI to examine via its 0-based index, and choose the info type you need for downstream processing or display.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| rxcuis | True | STRING | A JSON string representing an array of RxCUIs to choose from. The node will parse this string and use the index to select one RxCUI. | ["161", "198440", "1000004"] |
| selected_rxcui | True | INT | 0-based index into the parsed RxCUI list indicating which RxCUI to fetch information for. | 0 |
| info_type | True | ["name", "ndcs", "properties", "all_related"] | The category of information to retrieve for the selected RxCUI: 'name' (RxNorm display name), 'ndcs' (associated NDC codes), 'properties' (concept properties), or 'all_related' (all related concept information). | properties |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| concept_info | STRING | A prettified JSON string containing the selected RxCUI, the requested info_type, and the API response under 'data'. | { "rxcui": "161", "info_type": "properties", "data": { ... } } |
| rxcui | STRING | The selected RxCUI used to generate the result. | 161 |
| status | STRING | Status message indicating success or describing an error condition. | Successfully retrieved properties for RXCUI 161 |
Important Notes¶
- Input format: The rxcuis input must be a valid JSON array string (e.g., "[\"161\"]").
- Indexing: selected_rxcui is 0-based and must be within the bounds of the parsed rxcuis list.
- Validation: An empty or whitespace-only RxCUI will return an error.
- Info types: Only the values 'name', 'ndcs', 'properties', and 'all_related' are accepted.
- Output JSON: The concept_info output is a JSON string that includes keys 'rxcui', 'info_type', and 'data'.
- API dependency: This node depends on an external RxNorm service; network or service errors are surfaced in the status and concept_info fields.
Troubleshooting¶
- Selected RXCUI index out of range: Ensure selected_rxcui is less than the length of the rxcuis array.
- Invalid rxcuis JSON: Provide a properly formatted JSON array string (e.g., "[\"161\", \"198440\"]").
- Empty RxCUI: Remove empty strings from the rxcuis array; the node rejects empty RxCUI values.
- Unknown info type: Use one of the allowed values: name, ndcs, properties, all_related.
- API Error in status: Retry later or verify the RxCUI is valid; network/service issues or invalid identifiers can cause API errors.