Centers for Medicare and Medicaid Services API Reference API
Information about the state of Marketplace API.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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 API
curl "https://apis.io/api/v1/apis/cms-api-reference-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
OpenAPI Specification
openapi: 3.2.0
info:
title: Marketplace API Reference API
version: '1'
description: '# About
The Marketplace API delivers data that helps users find and evaluate health care insurance plans, providers, and coverage information on the marketplace.'
servers:
- url: https://marketplace.api.healthcare.gov/api/v1
security:
- API Key: []
tags:
- name: API Reference
description: Information about the state of Marketplace API.
paths:
/versions:
x-summary: API Version Info
get:
tags:
- API Reference
parameters:
- $ref: '#/components/parameters/apikey'
description: Get the last updated date for various data sets
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DataVersion'
summary: Get versions
x-summary-source: derived
operationId: getVersions
x-operation-id-source: derived
/market-years:
x-summary: Current and supported market years
get:
tags:
- API Reference
parameters:
- $ref: '#/components/parameters/apikey'
description: Get the current and supported market years
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MarketYears'
summary: Get market years
x-summary-source: derived
operationId: getMarketYears
x-operation-id-source: derived
components:
schemas:
MarketYear:
type: number
MarketYears:
description: Current and supported market years
type: object
properties:
current:
description: Current market year
type: number
supported:
description: Supported market years
type: array
items:
$ref: '#/components/schemas/MarketYear'
DataVersion:
type: object
properties:
name:
type: string
updated:
type: string
description: iso-8601 date
parameters:
apikey:
name: apikey
description: API key used for authentication
in: query
required: true
x-example: d687412e7b53146b2631dc01974ad0a4
schema:
type: string
securitySchemes:
API_Key:
x-summary: API Key Auth
description: Your API key should be included as a query parameter with the request. You can [fill out this form](https://cms.gov1.qualtrics.com/jfe/form/SV_4N2GHCJfNuX7n8x) to request an API key.
type: apiKey
in: query
name: apikey
x-example: d687412e7b53146b2631dc01974ad0a4