Plan

HealthcareMedicareMedicaidFHIRBulk DataOpen DataGovernmentFederalClaimsInsuranceACAMarketplaceQualityHealth InsuranceFederal GovernmentDrug SpendingProvider DataQuality MeasuresClaims DataGovernment Data

Properties

Name Type Description
id string 14-character HIOS plan ID
name string Name of the insurance plan
benefits array
deductibles array
disease_mgmt_programs array
has_national_network boolean if plan has a national network of providers
quality_rating object
insurance_market object
issuer object
market object
max_age_child number the maximum age a person is considered a child on their parents' plan
metal_level object
moops array
premium number monthly premium in US dollars, unsubsidized (i.e., no APTC applied)
premium_w_credit number monthly premium in US dollars, with APTC applied
ehb_premium number monthly premium in US dollars, for essential health benefits portion of total premium
pediatric_ehb_premium number monthly pediatric portion of the ehb premium in US dollars
aptc_eligible_premium number the portion of the premium that is eligible for APTC
guaranteed_rate boolean true if the premiums are guaranteed (versus estimated)
simple_choice boolean true if the plan is a Simple Choice plan
product_division object
specialist_referral_required boolean
state string 2-letter USPS state abbreviation
type object
benefits_url string
brochure_url string
formulary_url string
network_url string
hsa_eligible boolean Is this plan eligible as an HSA?
oopc number out-of-pocket cost; calculated when age, gender and utilization_level are present, otherwise -1
suppression_state object
tobacco_lookback integer
certification object
network_adequacy object Network adequacy
sbcs object Summary of benefits and costs
rx_3mo_mail_order boolean 3-month in-network mail order pharmacy benefit
is_ineligible boolean If the given enrollment group/household is ineligible for the plan by business rules, it will be flagged true
covers_nonhyde_abortion boolean
service_area_id string 6-character id representing the geographic area the plan accepts members from. The first two characters are the state's abbreviation.
View JSON Schema on GitHub

JSON Schema

cms-gov-plan-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cms-gov/json-schema/cms-gov-plan-schema.json",
  "title": "Plan",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cms-gov-insurance-plans-api-openapi.yml#/components/schemas/Plan",
  "properties": {
    "id": {
      "description": "14-character HIOS plan ID",
      "type": "string"
    },
    "name": {
      "description": "Name of the insurance plan",
      "type": "string"
    },
    "benefits": {
      "items": {
        "$ref": "#/$defs/Benefit"
      },
      "type": "array"
    },
    "deductibles": {
      "items": {
        "$ref": "#/$defs/Deductible"
      },
      "type": "array"
    },
    "disease_mgmt_programs": {
      "items": {
        "$ref": "#/$defs/DiseaseMgmtProgramsEnum"
      },
      "type": "array"
    },
    "has_national_network": {
      "description": "if plan has a national network of providers",
      "type": "boolean"
    },
    "quality_rating": {
      "$ref": "#/$defs/QualityRating"
    },
    "insurance_market": {
      "$ref": "#/$defs/InsuranceMarketEnum"
    },
    "issuer": {
      "$ref": "#/$defs/Issuer"
    },
    "market": {
      "$ref": "#/$defs/MarketEnum"
    },
    "max_age_child": {
      "description": "the maximum age a person is considered a child on their parents' plan",
      "format": "int32",
      "type": "number"
    },
    "metal_level": {
      "$ref": "#/$defs/MetalLevelEnum"
    },
    "moops": {
      "items": {
        "$ref": "#/$defs/MOOP"
      },
      "type": "array"
    },
    "premium": {
      "description": "monthly premium in US dollars, unsubsidized (i.e., no APTC applied)",
      "format": "float",
      "type": "number"
    },
    "premium_w_credit": {
      "description": "monthly premium in US dollars, with APTC applied",
      "format": "float",
      "type": "number"
    },
    "ehb_premium": {
      "description": "monthly premium in US dollars, for essential health benefits portion of total premium",
      "format": "float",
      "type": "number"
    },
    "pediatric_ehb_premium": {
      "description": "monthly pediatric portion of the ehb premium in US dollars",
      "type": "number",
      "format": "float"
    },
    "aptc_eligible_premium": {
      "description": "the portion of the premium that is eligible for APTC",
      "type": "number",
      "format": "float"
    },
    "guaranteed_rate": {
      "description": "true if the premiums are guaranteed (versus estimated)",
      "type": "boolean"
    },
    "simple_choice": {
      "description": "true if the plan is a Simple Choice plan",
      "type": "boolean"
    },
    "product_division": {
      "$ref": "#/$defs/ProductDivisionEnum"
    },
    "specialist_referral_required": {
      "type": "boolean"
    },
    "state": {
      "description": "2-letter USPS state abbreviation",
      "type": "string"
    },
    "type": {
      "$ref": "#/$defs/PlanTypeEnum"
    },
    "benefits_url": {
      "type": "string"
    },
    "brochure_url": {
      "type": "string"
    },
    "formulary_url": {
      "type": "string"
    },
    "network_url": {
      "type": "string"
    },
    "hsa_eligible": {
      "description": "Is this plan eligible as an HSA?",
      "type": "boolean"
    },
    "oopc": {
      "description": "out-of-pocket cost; calculated when age, gender and utilization_level are present, otherwise -1",
      "type": "number"
    },
    "suppression_state": {
      "$ref": "#/$defs/SuppressionStatus"
    },
    "tobacco_lookback": {
      "type": "integer"
    },
    "certification": {
      "$ref": "#/$defs/CertificationStatus"
    },
    "network_adequacy": {
      "description": "Network adequacy",
      "type": "object",
      "properties": {
        "scope": {
          "description": "The county for which the network adequacy is in scope",
          "type": "string"
        },
        "networks": {
          "description": "Specialty networks and their network types",
          "type": "object"
        }
      }
    },
    "sbcs": {
      "description": "Summary of benefits and costs",
      "type": "object",
      "properties": {
        "baby": {
          "description": "Typical yearly costs for having a healthy pregnancy and normal delivery for one person",
          "allOf": [
            {
              "$ref": "#/$defs/SBCScenario"
            }
          ]
        },
        "diabetes": {
          "description": "Typical yearly costs for managing type 2 diabetes for one person",
          "allOf": [
            {
              "$ref": "#/$defs/SBCScenario"
            }
          ]
        },
        "fracture": {
          "description": "Typical yearly costs for treating a simple fracture",
          "allOf": [
            {
              "$ref": "#/$defs/SBCScenario"
            }
          ]
        }
      }
    },
    "rx_3mo_mail_order": {
      "description": "3-month in-network mail order pharmacy benefit",
      "type": "boolean"
    },
    "is_ineligible": {
      "description": "If the given enrollment group/household is ineligible for the plan by business rules, it will be flagged true",
      "type": "boolean"
    },
    "covers_nonhyde_abortion": {
      "type": "boolean"
    },
    "service_area_id": {
      "description": "6-character id representing the geographic area the plan accepts members from.  The first two characters are the state's abbreviation.",
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "Benefit": {
      "properties": {
        "name": {
          "type": "string"
        },
        "covered": {
          "type": "boolean"
        },
        "cost_sharings": {
          "items": {
            "$ref": "#/$defs/CostSharing"
          },
          "type": "array"
        },
        "explanation": {
          "type": "string"
        },
        "exclusions": {
          "type": "string"
        },
        "has_limits": {
          "type": "boolean"
        },
        "limit_unit": {
          "type": "string"
        },
        "limit_quantity": {
          "format": "integer",
          "type": "number"
        }
      },
      "type": "object"
    },
    "CertificationStatus": {
      "type": "string",
      "enum": [
        "Certified",
        "Not Certified",
        "Decertified",
        "Certified Off-Exchange SADP"
      ]
    },
    "CostSharing": {
      "properties": {
        "coinsurance_options": {
          "type": "string"
        },
        "coinsurance_rate": {
          "format": "float",
          "type": "number"
        },
        "copay_amount": {
          "type": "number"
        },
        "copay_options": {
          "type": "string"
        },
        "network_tier": {
          "$ref": "#/$defs/NetworkTierEnum"
        },
        "csr": {
          "$ref": "#/$defs/CostSharingReductionEnum"
        },
        "display_string": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "CostSharingReductionEnum": {
      "type": "string",
      "description": "Cost-sharing reduction (CSR)",
      "enum": [
        "Exchange variant (no CSR)",
        "Zero Cost Sharing Plan Variation",
        "Limited Cost Sharing Plan Variation",
        "73% AV Level Silver Plan CSR",
        "87% AV Level Silver Plan CSR",
        "94% AV Level Silver Plan CSR",
        "Non-Exchange variant",
        "Unknown CSR"
      ],
      "properties": {}
    },
    "Deductible": {
      "properties": {
        "amount": {
          "type": "number"
        },
        "csr": {
          "$ref": "#/$defs/CostSharingReductionEnum"
        },
        "family_cost": {
          "$ref": "#/$defs/FamilyCostEnum"
        },
        "network_tier": {
          "$ref": "#/$defs/NetworkTierEnum"
        },
        "type": {
          "enum": [
            "Medical EHB Deductible",
            "Combined Medical and Drug EHB Deductible",
            "Drug EHB Deductible"
          ],
          "type": "string"
        },
        "individual": {
          "description": "Applies to individuals",
          "type": "boolean"
        },
        "family": {
          "description": "Applies to families",
          "type": "boolean"
        },
        "display_string": {
          "type": "string",
          "description": "An optional human-readable description"
        }
      },
      "type": "object"
    },
    "DiseaseMgmtProgramsEnum": {
      "enum": [
        "Asthma",
        "Heart Disease",
        "Depression",
        "Diabetes",
        "High Blood Pressure and High Cholesterol",
        "Low Back Pain",
        "Pain Management",
        "Pregnancy",
        "Weight Loss Programs"
      ],
      "type": "string",
      "properties": {}
    },
    "FamilyCostEnum": {
      "description": "family cost enumeration for MOOPs and deductibles",
      "enum": [
        "Individual",
        "Family Per Person",
        "Family"
      ],
      "type": "string",
      "properties": {}
    },
    "InsuranceMarketEnum": {
      "enum": [
        "QHP",
        "MSP"
      ],
      "type": "string",
      "properties": {}
    },
    "Issuer": {
      "properties": {
        "eligible_dependents": {
          "description": "list of allowed relationship types for dependents",
          "items": {
            "$ref": "#/$defs/Relationship"
          },
          "type": "array"
        },
        "id": {
          "description": "5-digit HIOS ID",
          "type": "string"
        },
        "individual_url": {
          "description": "URL for individual market plans",
          "type": "string"
        },
        "name": {
          "description": "issuer's name",
          "type": "string"
        },
        "shop_url": {
          "description": "URL for SHOP market plans",
          "type": "string"
        },
        "state": {
          "description": "2-letter USPS state abbreviation",
          "type": "string"
        },
        "toll_free": {
          "description": "toll-free customer service phone number",
          "type": "string"
        },
        "tty": {
          "description": "TTY customer service number)",
          "type": "string"
        }
      },
      "type": "object"
    },
    "MOOP": {
      "description": "maximum out-of-pocket",
      "properties": {
        "amount": {
          "type": "number"
        },
        "csr": {
          "$ref": "#/$defs/CostSharingReductionEnum"
        },
        "family_cost": {
          "type": "string",
          "enum": [
            "Individual",
            "Family",
            "Family Per Person"
          ]
        },
        "network_tier": {
          "$ref": "#/$defs/NetworkTierEnum"
        },
        "type": {
          "enum": [
            "Maximum Out of Pocket for Medical and Drug EHB Benefits (Total)",
            "Maximum Out of Pocket for Medical EHB Benefits",
            "Maximum Out of Pocket for Drug EHB Benefits"
          ],
          "type": "string"
        },
        "individual": {
          "description": "Applies to individuals",
          "type": "boolean"
        },
        "family": {
          "description": "Applies to families",
          "type": "boolean"
        },
        "display_string": {
          "type": "string",
          "description": "An optional human-readable description"
        }
      },
      "type": "object"
    },
    "MarketEnum": {
      "enum": [
        "Individual",
        "SHOP",
        "Any"
      ],
      "type": "string",
      "properties": {}
    },
    "MetalLevelEnum": {
      "enum": [
        "Catastrophic",
        "Silver",
        "Bronze",
        "Gold",
        "Platinum"
      ],
      "type": "string",
      "properties": {}
    },
    "NetworkTierEnum": {
      "enum": [
        "In-Network",
        "In-Network Tier 2",
        "Out-of-Network",
        "Combined In-Out of Network"
      ],
      "type": "string",
      "properties": {}
    },
    "PlanTypeEnum": {
      "enum": [
        "Indemnity",
        "PPO",
        "HMO",
        "EPO",
        "POS"
      ],
      "type": "string"
    },
    "ProductDivisionEnum": {
      "enum": [
        "HealthCare",
        "Dental"
      ],
      "type": "string"
    },
    "QualityRating": {
      "properties": {
        "available": {
          "type": "boolean",
          "description": "True if the plan has a quality rating, otherwise false.  A plan can still be unrated when the quality rating is available"
        },
        "year": {
          "x-example": 2019,
          "type": "integer"
        },
        "global_rating": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        },
        "global_not_rated_reason": {
          "type": "string"
        },
        "clinical_quality_management_rating": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        },
        "clinical_quality_management_not_rated_reason": {
          "type": "string"
        },
        "enrollee_experience_rating": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        },
        "enrollee_experience_not_rated_reason": {
          "type": "string"
        },
        "plan_efficiency_rating": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        },
        "plan_efficiency_not_rated_reason": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "Relationship": {
      "description": "Should match one of the [listed valid relationships](#introduction/more-information-about-households).",
      "type": "string",
      "properties": {}
    },
    "SBCScenario": {
      "type": "object",
      "properties": {
        "deductible": {
          "type": "number",
          "format": "float"
        },
        "copay": {
          "type": "number",
          "format": "float"
        },
        "coinsurance": {
          "type": "number",
          "format": "float"
        },
        "limit": {
          "type": "number",
          "format": "float"
        }
      }
    },
    "SuppressionStatus": {
      "type": "string",
      "enum": [
        "Available",
        "Suspended",
        "Closed",
        "Not Applicable"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cms-gov-plan"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.