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. |
JSON Schema
{
"$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.
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.