For AI agents: the documentation index is at /docs/payerbox/llms.txt. A Markdown version of this page is available at /docs/payerbox/data-integration/drug-formulary/payer-plans/drug-plan-tier-benefits.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Drug Plan Tier Benefits

Datasets

Part of the Payer Plans group of the Drug Formulary feed, built to Da Vinci PDex US Drug Formulary STU 2.1.0. The feed's data conventions apply.

DatasetUS Drug Formulary STU 2.1.0 target elementCardinality
drug_plan_tier_benefitsplan:drug-plan.specificCost.benefit of the Payer Insurance Plan1..*, must support

A tier benefit is one drug tier within one pharmacy benefit type. It has no fields of its own beyond the tier; it exists to hang the copay and coinsurance on.

drug_plan_tier_benefits

One row per drug tier under a pharmacy benefit type.

ColumnRequiredFormat / valuesExample
drug_plan_idYeskey from drug_plansDP-DSNP
pharmacy_benefit_typeYeskey from drug_plan_specific_costs, with drug_plan_id1-month-in-retail
drug_tierYessee Drug tiers; becomes typegeneric
is_deletedIf retractingtrue retracts this row and its coststrue
  • A row is identified by drug_plan_id, pharmacy_benefit_type and drug_tier together.
  • Every row needs at least one cost under it.
  • The tiers a drug plan lists here are the ones its formulary items may name in drug_tier.

Drug tiers

drug_tier is the plan's own tier for the drug. The IG ships an example set, DrugTierVS, and expects plans to use their own where these do not fit. Send the code your plan documents use; if it is not one of these, tell us during scoping so the tier is registered.

ValueMeaning
preferred-genericcommonly prescribed generic drugs
genericgeneric drugs that cost more than preferred generics
non-preferred-genericgeneric drugs that cost more than the generic tier
preferred-brandbrand-name drugs preferred by the plan
brandbrand-name drugs that cost more than preferred brands
non-preferred-brandbrand-name drugs that cost more than the brand tier
preferreddrugs preferred by the plan, where tiers are not split by generic and brand
non-preferreddrugs that cost more than the preferred tier
specialtydrugs for complex conditions, generic or brand, often with special handling
zero-cost-share-preventativepreventive drugs available at no cost
medical-servicedrugs administered by a clinician or in a facility, covered under the medical benefit

These resources are served by Patient Access.

Last updated: