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

Plan Identifiers

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
plan_identifiersidentifier of the Payer Insurance Plan1..*

The profile requires at least one identifier per plan. plan_id on the root row is always the first; this dataset carries every other identifier the plan is known by, each with the namespace it belongs to.

plan_identifiers

One row per additional identifier of a plan.

ColumnRequiredFormat / valuesExample
plan_idYeskey from payer_plansPLAN-DSNP
identifier_valueYesthe identifier as issuedH6776-001-000
identifier_systemYesURI of the namespace that issued ithttp://cms.gov/medicare/ma-plan-id
is_deletedIf retractingtrue retracts this rowtrue
  • A row is identified by plan_id, identifier_system and identifier_value together; there is no separate key.
  • The CMS contract-plan-segment (H#####-###-###) is the identifier every Medicare Advantage plan should carry here. Use one namespace URI for it consistently across plans and across the Provider Directory feed, so the two feeds' InsurancePlans match on it.
  • plan_id itself is not repeated here. It is published as the first identifier automatically.

These resources are served by Patient Access.

Last updated: