Skip to main content

Overview

The Benefit Plan Standard defines a canonical JSON data model for representing health benefit plan designs across carriers. It provides a single unified structure for cost‑sharing information, network tiers, accumulators, service definitions, visit limits, and other plan metadata. The goal is to simplify the exchange of benefit data, enable accurate plan comparison, and power new analytics and applications.

This overview introduces the major concepts in the specification and links to detailed sections.

Why a New Standard?

Benefit plans today are published in human‑readable PDFs and spreadsheets. Carriers describe deductibles, copays, and out‑of‑pocket maximums in inconsistent formats, making automated processing nearly impossible. Brokers, employers and insurtechs must invest in bespoke data pipelines for each carrier.

The Benefit Plan Standard solves this by defining:

  • A core JSON schema describing plan metadata, network tiers, accumulators, benefit rows and cost shares.
  • A field definition matrix that maps carrier vocabulary to standardized fields.
  • Validation rules for structural and semantic integrity.
  • Extensible modules to incorporate pharmacy, dental, vision and other lines of business.

High‑Level Model

At the highest level, a normalized plan is represented as a single JSON object with the following top‑level keys:

FieldDescription
plan_idUnique identifier for the plan, often a combination of carrier and year
carrierName of the issuing carrier
product_typeInsurance product type (e.g., PPO, HMO, Medicare Advantage)
effective_dateDate the plan becomes effective
network_tiersList of network tiers (e.g., in‑network, out‑of‑network)
accumulatorsDeductibles and out‑of‑pocket maximums, individual and family
benefitsArray of benefit items describing cost sharing per service
source_refsReferences back to the original document for auditing

You can see the full JSON schema definition in the benefit‑plan‑schema repository.

Next Steps

  • Field Definitions — A detailed description of every field in the schema.
  • Crosswalk — How carrier terms map into normalized fields.
  • Modules — Extensions for pharmacy, behavioral health and other lines of business.