{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://benefitplanstandard.org/schema/v1.2.0/formulary.schema.json",
  "title": "Benefit Plan Standard Formulary List",
  "description": "A drug list written once for the plans that share it (new in v1.2.0). Many plans use 1 formulary: in the CMS monthly Part D formulary files for contract year 2027, 286 formularies serve 5,492 plans, up to 660 plans each, so a list written into every plan document would be written up to 660 times. A plan document names the list with pharmacy.formulary_reference.formulary_items_url and keeps in its own pharmacy.formulary_items only what is the plan's alone; an item there replaces a list item with the same rxcui and coverage_basis. The list carries no tiers: each item's formulary_tier_id names a tier in the pharmacy.formulary_tiers of every plan document that points at the list. The item and reference shapes are the core schema's (benefit-plan.schema.json in this folder), so a validator loads both files.",
  "type": "object",
  "properties": {
    "formulary_reference": {
      "$ref": "benefit-plan.schema.json#/$defs/formulary_reference",
      "description": "Identity and provenance of the list: formulary_id and formulary_version as the source names them, completeness, and data_sources. source_plan_identifiers and formulary_items_url, which describe 1 plan, are left out of a list."
    },
    "plan_year": {
      "type": "integer",
      "description": "The coverage year the list applies to (e.g. 2027), the core schema's plan_year: a formulary id can carry a different list in another year.",
      "minimum": 1900,
      "maximum": 2100
    },
    "formulary_items": {
      "type": "array",
      "description": "The drugs on the list, in the shape of the core schema's pharmacy.formulary_items[].",
      "items": { "$ref": "benefit-plan.schema.json#/$defs/formulary_item" }
    },
    "source_references": {
      "type": "array",
      "description": "Citations for the list as a whole, such as the source file's header row, in the shape of the core schema's source_references.",
      "items": { "$ref": "benefit-plan.schema.json#/$defs/source_reference" }
    },
    "schema_version": {
      "type": "string",
      "description": "Version of the Benefit Plan Standard schema used to validate this document (e.g. '1.2.0')."
    }
  },
  "required": ["formulary_reference", "formulary_items", "schema_version"],
  "additionalProperties": false
}
