# getAllRelatedConcepts

**Identifier:** `rxnorm_getAllRelatedConcepts`

**Provider:** [RxNorm](https://kirha.com/providers/rxnorm.md)

Retrieve all related RxNorm concepts for one or more RxCUIs, grouped by term type (ingredients, brands, clinical drugs, dose forms, packs). Use this to explore the full RxNorm graph for drug concepts.

## Run it with the CLI

```bash
kirha tools run rxnorm_getAllRelatedConcepts \
  --input '{
    "rxcuis": [
      "<rxcuis>"
    ]
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "rxnorm_getAllRelatedConcepts",
  "input": {
    "rxcuis": [
      "<rxcuis>"
    ]
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "rxcuis": {
      "description": "From findDrugByName or getDrugProducts",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "rxcuis"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "groups": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "conceptCount": {
            "description": "Concepts of this term type before the cap",
            "type": "number"
          },
          "concepts": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "RxCUI -> concept name, about 1100 per call split evenly across inputs; getRelatedByType for one term type",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "query": {
            "description": "Input RxCUI these concepts relate to",
            "type": "string"
          },
          "tty": {
            "type": "string"
          }
        },
        "required": [
          "query",
          "tty",
          "conceptCount",
          "concepts"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "rxcuis": {
      "description": "RxCUIs of the returned concepts for use with other RxNorm tools",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "groups",
    "rxcuis"
  ],
  "type": "object"
}
```

## Related tools

Other RxNorm tools that this tool refers to, or that refer to it.

- [`findDrugByName`](https://kirha.com/providers/rxnorm/findDrugByName.md)
- [`getDrugProducts`](https://kirha.com/providers/rxnorm/getDrugProducts.md)
- [`getRelatedByType`](https://kirha.com/providers/rxnorm/getRelatedByType.md)

-----

[All RxNorm tools](https://kirha.com/providers/rxnorm.md) · [< Back to tools list](https://kirha.com/tools.md)