API Reference

Create a free API key. Returns the key once — store it securely. Submitting the same email twice returns 409.

curl -X POST https://your-domain.com/v1/keys/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

{
  "api_key":       "rxb_a3f2d...",
  "email":         "you@example.com",
  "tier":          "free",
  "monthly_quota": 500
}

Normalize messy drug free-text to a canonical RxNorm RXCUI, NDC, dosage form, and strength. Handles misspellings, abbreviations (HCTZ, MetXR, Coumadin), and free-text dose noise. Returns the best match with confidence score plus ranked alternates.

curl -X POST https://your-domain.com/v1/normalize \
  -H "Authorization: Bearer rxb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "metformn 500 tab"}'

{
  "query": "metformn 500 tab",
  "match": {
    "rxcui":             "861007",
    "ndc":               "00093-7214-01",
    "ingredient":        "metformin",
    "brand":             "Glucophage",
    "dosage_form":       "tablet",
    "strength":          "500 mg",
    "description":       "Metformin is an oral diabetes medicine...",
    "description_source": "rxbridge_curated",
    "confidence":        0.92
  },
  "alternatives": [...]
}

Look up all catalog entries for a given RxNorm RXCUI, including lay-level patient description.

curl https://your-domain.com/v1/drug/861007 \
  -H "Authorization: Bearer rxb_your_key"

{
  "rxcui":      "861007",
  "description": "Metformin is an oral diabetes medicine that helps control blood sugar...",
  "results": [
    { "rxcui": "861007", "ingredient": "metformin", "brand": "Glucophage",
      "dosage_form": "tablet", "strength": "500 mg" }
  ]
}

Check drug-drug interaction evidence for 2–10 drugs. Returns severity-tagged evidence objects sourced from FDA drug labels. Framed strictly as evidence — not clinical verdicts. Every response includes a mandatory disclaimer field.

curl -X POST https://your-domain.com/v1/interactions \
  -H "Authorization: Bearer rxb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"drugs": ["warfarin 5mg", "aspirin 81mg"]}'

{
  "resolved": [
    { "query": "warfarin 5mg", "rxcui": "855332", "ingredient": "warfarin" },
    { "query": "aspirin 81mg", "rxcui": "1191",   "ingredient": "aspirin" }
  ],
  "interactions": [
    {
      "drug_pair": ["warfarin", "aspirin"],
      "severity": "major",
      "summary":  "Aspirin can potentiate warfarin's anticoagulant effect...",
      "evidence": {
        "source_label":   "Coumadin (warfarin) FDA label",
        "source_section": "Drug Interactions (Section 7)",
        "snippet":        "Aspirin inhibits platelet aggregation..."
      }
    }
  ],
  "disclaimer": "EVIDENCE ONLY — not medical advice..."
}

The combined one-call endpoint. Accepts messy drug text (single string or list), normalizes each to canonical RXCUI + dosage form + lay description, then cross-checks all drug pairs for severity-tagged interaction evidence — all in a single request. This is the wedge.

curl -X POST https://your-domain.com/v1/medication \
  -H "Authorization: Bearer rxb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"medications": ["metformn 500 tab", "lisinprl 10mg", "atorvastn 40"]}'

{
  "medications": [
    {
      "input":      "metformn 500 tab",
      "resolved":   true,
      "confidence": 0.92,
      "match": {
        "rxcui":       "861007",
        "ingredient":  "metformin",
        "brand":       "Glucophage",
        "dosage_form": "tablet",
        "strength":    "500 mg",
        "description": "Metformin is an oral diabetes medicine..."
      }
    }
  ],
  "interactions": [],
  "disclaimer":   "EVIDENCE ONLY — not medical advice..."
}

Returns current monthly usage and quota for the authenticated key, with a per-endpoint breakdown.

curl https://your-domain.com/v1/usage \
  -H "Authorization: Bearer rxb_your_key"

{
  "email":      "you@example.com",
  "tier":       "free",
  "usage":      14,
  "limit":      500,
  "remaining":  486,
  "period":     "2026-06",
  "by_endpoint": {
    "/v1/normalize":  8,
    "/v1/medication": 6
  }
}