Technical Reference

Data Model

A normalized, RxNorm-centered schema with modular enrichment layers for drug intelligence, clinical inference, and market pricing. Every table is API-accessible and designed for direct integration into analytics workflows.

Entity Relationships

Schema Overview

Core entity relationships across the drug hierarchy, enrichment layers, and pricing systems. Click any entity in the detailed view below to inspect columns.

ingredientclinical_drug_formdrug_detailref.icd10drug_icd10_estimatedrug_therapy_attributesuspecting_rulenadac_pricingasp_payment_limitsmedicaid_sdu_cleanpartd_spending_clean
Foundation / Intelligence
Inference & Analytics
Market Intelligence
Detailed Schema

Tables by Layer

RxNorm Foundation

Foundation
rxnorm.drug_detail
13 cols

Complete drug hierarchy — ingredient through branded product. One row per SCD/SBD concept.

rxnorm.clinical_drug_form
3 cols

Ingredient + dose form (strength-agnostic). Central join point for enrichment layers.

ingredient
2 cols

RxNorm ingredient concepts (TTY = IN or MIN).

ref.icd10
2 cols

ICD-10 diagnosis code reference table.

ref.atc
3 cols

WHO ATC therapeutic classification hierarchy.

Drug Intelligence

Reference Intelligence
drug_icd10_estimate
8 cols

Utilization-weighted drug-to-diagnosis mappings. Multi-provider consensus scoring across conditions.

drug_therapy_attribute
8 cols

Therapy behavior classification per drug form — maintenance, specialty, benefit channel, adherence eligibility.

Suspecting Rules

Inference & Analytics
suspecting_rule
11 cols

Executable clinical logic for diagnosis inference from claims data. Supports compound rules across specialty, age, concurrent Rx, and medical history.

Market Pricing

Market Intelligence
nadac_pricing
7 cols

Weekly CMS NADAC rates per NDC. National average drug acquisition cost for retail pharmacy.

asp_payment_limits
6 cols

Quarterly Medicare Part B ASP+6% payment limits per HCPCS code.

Spending Analytics

Market Intelligence
medicaid_sdu_clean
9 cols

Cleaned Medicaid State Drug Utilization with RxCUI resolution, anomaly flags, and dual-path NDC matching.

partd_spending_clean
8 cols

Cleaned Medicare Part D spending at ingredient level with year-over-year analytics.

Integration Patterns

Common Join Paths

Pre-validated join paths for the most common analytical workflows. Each path represents a tested integration pattern available through the API.

Drug Hierarchy

Navigate the full RxNorm concept tree from ingredient through drug form to specific product

ingredientclinical_drug_formdrug_detail
Diagnosis Mapping

Resolve drug-to-condition relationships with utilization-weighted volume estimates

clinical_drug_formdrug_icd10_estimateref.icd10
Suspecting Logic

From drug concept to executable inference rules with structured rule logic

clinical_drug_formsuspecting_rulerule_logic (JSON)
NADAC Pricing

Weekly acquisition cost per NDC joined to the drug hierarchy

drug_detailnadac_pricingvw_nadac_latest
ASP Pricing

Quarterly Medicare Part B payment limits per HCPCS code

asp_payment_limitsvw_asp_current_limits
Spending Analytics

Claims volume and cost trending at ingredient or drug level

medicaid_sdu_clean / partd_spending_cleaningredient_rxcuiingredient
Controlled Vocabularies

Enumerated Values

Standardized enum values used across enrichment layers. All values are validated at ingestion time.

therapy_pattern
maintenance_continuousmaintenance_intermittentacute_short_courseprn_chronicprn_acutemixed_contextual
rule_category
prescriber_specialtypatient_agepatient_genderconcurrent_rxmedical_claims_historycompoundsingle_indication
rule_strength
exclusionstrong_priorweak_prior
indication_direction
towardawayswitch
signal_source
rx_onlydemographicsconcurrent_rxmedical_claims_historycompound
benefit_channel
pharmacy_onlymedical_onlydual_channel
Conventions

Column Naming

ConceptColumn NameRxNorm TTYExample
Drug (ingredient + form + strength)drug_idSCD / SBD617314
Ingredientingredient_rxcuiIN / MIN143
Clinical Drug Formclinical_drug_form_rxcuiSCDF / SBDF310193
NDC 11-digitndc1100071213901
NDC 9-digitndc9000712139
HCPCS Codehcpcs_codeJ7502
ATC Codeatc_codeC10AA05