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-specific-costs.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Drug Plan Specific Costs

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_specific_costsplan:drug-plan.specificCost of the Payer Insurance Plan1..*, must support

A specific cost is one pharmacy benefit type of the drug plan: a channel and supply length, such as a one-month supply at an in-network retail pharmacy. The tiers and their amounts hang below it.

drug_plan_specific_costs

One row per pharmacy benefit type of a drug plan.

ColumnRequiredFormat / valuesExample
drug_plan_idYeskey from drug_plansDP-DSNP
pharmacy_benefit_typeYessee Pharmacy benefit types; becomes category1-month-in-retail
is_deletedIf retractingtrue retracts this row and the tiers under ittrue
  • A row is identified by drug_plan_id and pharmacy_benefit_type together.
  • Every row needs at least one tier benefit under it.
  • The pharmacy benefit types a drug plan lists here are the ones its formulary items may name in pharmacy_benefit_types.

Pharmacy benefit types

pharmacy_benefit_type says through which channel and supply length a cost applies. The set is the IG's own PharmacyBenefitTypeVS, extensible: a plan may add its own codes, and then defines them in a code system Payerbox registers per engagement.

ValueMeaning
1-month-in-retail1-month supply, in-network retail pharmacy
1-month-out-retail1-month supply, out-of-network retail pharmacy
1-month-in-mail1-month supply, in-network mail order
1-month-out-mail1-month supply, out-of-network mail order
3-month-in-retail3-month supply, in-network retail pharmacy
3-month-out-retail3-month supply, out-of-network retail pharmacy
3-month-in-mail3-month supply, in-network mail order
3-month-out-mail3-month supply, out-of-network mail order

These resources are served by Patient Access.

Last updated: