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

Drug Plans

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_plansplan:drug-plan of the Payer Insurance Plan1..*

A drug plan is the cost-sharing structure offered under a payer plan. A product usually has one; a product sold with several cost-sharing designs has one per design. Its cost table lives in the three datasets below it.

drug_plans

One row per drug plan.

ColumnRequiredFormat / valuesExample
drug_plan_idYesyour stable key for the drug plan; it becomes the drug plan's identifier and links a member's Coverage to itDP-DSNP
plan_idYeskey from payer_plansPLAN-DSNP
identifier_valuesIf availablefurther identifiers of the drug plan, ;-separated, aligned with identifier_systemsH6776-001-000
identifier_systemsIf identifier_valuesnamespace URI of each, alignedhttp://cms.gov/medicare/ma-plan-id
coverage_area_idsIf different from the plan'skeys from coverage_areas, ;-separated
network_idsIf availablepharmacy networks of this drug plan, keys from Provider Directory networks, ;-separatedNET-001
is_deletedIf retractingtrue retracts the drug plan and its cost tabletrue
  • drug_plan_id is published as the drug plan's identifier, which 2.1.0 made must-support so a member's Coverage can point at the drug plan inside a product. Keep it stable; enrollment data will reference it.
  • type is fixed to drug and set by Payerbox.
  • identifier_values and identifier_systems are one aligned list. They become further identifier entries after drug_plan_id; the profile marks the drug plan identifier must-support and repeatable.
  • Not collected: plan.generalCost is its own dataset, drug_plan_general_costs; nothing else of the drug plan is left out.
  • A drug plan needs at least one specific cost; a drug_plans row with none is reported and not published.

These resources are served by Patient Access.

Last updated: