RxNorm API

Look up RxNorm (RxCUI) information for normalized drug names and relationships.

Overview

RxNorm provides normalized names for clinical drugs and links to many drug vocabularies. FHIRfly provides fast lookups against the NLM RxNorm database.

Endpoints

Method	Path	Description
GET	`/v1/rxnorm/:rxcui`	Single RxCUI lookup
POST	`/v1/rxnorm/_batch`	Batch RxCUI lookup (up to 100)
GET	`/v1/rxnorm/shapes`	List available response shapes

Single Lookup

Look up acetohexamide by RxCUI

Request

curl -X GET "https://api.fhirfly.io/v1/rxnorm/173" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

JSON

{
  "data": {
    "brand_names": [],
    "ingredients": [],
    "is_prescribable": false,
    "name": "acetohexamide",
    "ndcs": [],
    "rxcui": "173",
    "semantic_types": [
      "Organic Chemical",
      "Pharmacologic Substance"
    ],
    "status": "ACTIVE",
    "tty": "IN"
  },
  "meta": {
    "legal": {
      "attribution_required": false,
      "citation": "RxNorm from NLM. Accessed 2026-01-14 via FHIRfly.",
      "license": "public_domain",
      "source_name": "RxNorm"
    }
  }
}

Term Types (TTY)

Common RxNorm term types:

TTY	Description
`IN`	Ingredient
`SCD`	Semantic Clinical Drug
`SBD`	Semantic Branded Drug
`GPCK`	Generic Pack
`BPCK`	Branded Pack
`BN`	Brand Name

Batch Lookup

Look up multiple RxCUIs in a single request (up to 100):

Look up multiple drugs

Request

curl -X POST "https://api.fhirfly.io/v1/rxnorm/_batch" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "rxcuis": [
      "173",
      "38",
      "44"
    ]
  }'

Response

JSON

{
  "data": {
    "found": 3,
    "not_found": 0,
    "results": [
      {
        "rxcui": "173",
        "data": {
          "name": "acetohexamide",
          "tty": "IN",
          "status": "ACTIVE"
        }
      },
      {
        "rxcui": "38",
        "data": {
          "name": "Parlodel",
          "tty": "BN",
          "status": "ACTIVE"
        }
      },
      {
        "rxcui": "44",
        "data": {
          "name": "mesna",
          "tty": "IN",
          "status": "ACTIVE"
        }
      }
    ]
  }
}

Response Shapes

Control the level of detail in responses with the shape query parameter:

Shape	Description
`compact`	Minimal data for lists and autocomplete
`standard`	Core structured data (default)
`full`	Complete data with provenance for AI agents

# Minimal data
GET /v1/rxnorm/173?shape=compact

# Standard data (default)
GET /v1/rxnorm/173?shape=standard

# Full data with provenance
GET /v1/rxnorm/173?shape=full

See Response Shapes for field details.

Required Scopes

rxnorm:read - Single lookups
rxnorm:batch - Batch lookups