Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Centers for Medicare and Medicaid Services Bulk Data API

Information about the bulk data json files maintained by Marketplace API.

Centers for Medicare and Medicaid Services Bulk Data API is one of 16 APIs that Centers for Medicare and Medicaid Services publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Bulk Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a GitHub repository.

This API exposes 6 operations across 6 paths, and defines 17 schemas. It is described by OpenAPI 2.0, at version 1.

Requests are made against the base URL https://marketplace.api.healthcare.gov/api/v1.

6 operations 6 paths 17 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1
Base URL
https://marketplace.api.healthcare.gov/api/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Centers for Medicare and Medicaid Services Bulk Data API declares 1 security scheme for authenticating requests. An API key is passed in the query as apikey (API Key). By default, every request must be authenticated.

  • API Key — 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/SV4N2GHCJfNuX7n8x)…

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

Bulk Data 6

Information about the bulk data json files maintained by Marketplace API.

GET
/data/apt
Bulk data containing our Applicable Percentage Tables
2 params → 302400
GET
/data/decile-mapping
Bulk data containing our OOPC Utilization Decile Mapping
2 params → 302400
GET
/data/state-medicaid
Bulk data containing our State Medicaid data
2 params → 302400
GET
/data/rate-areas
Bulk data containing our rate area information
2 params → 302400
GET
/data/county-zips
Bulk data containing our county zip information
2 params → 302400
GET
/data/crosswalk
Bulk data containing our Crosswalk data
2 params → 302400

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are StateMedicaid (12 properties), CrosswalkData (7 properties), DecileUtilizationAgeMap (7 properties), StateMedicaidList (3 properties). Each schema is shown below with its type and property counts.

StateRateArea
object
2 properties
DecileEnum
string
CrosswalkCode
object
2 properties
StateCounty
object
2 properties
DecileUtilizationAgeMap
object
7 properties
RateAreaCounty
object
2 properties
Range
object
2 properties
APTTier
object
2 properties
Crosswalk
object
3 properties
DecileUtilizationMapping
object
2 properties
StateMedicaid
object
12 properties
DecileMapping
object
3 properties
APT
object
2 properties
CountyZips
object
3 properties
StateMedicaidList
object
3 properties
CrosswalkData
object
7 properties
LowIncomeChild
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cms-bulk-data-api-openapi.yml Raw ↑

Other APIs Centers for Medicare and Medicaid Services publishes across the network.

CMS Beneficiary Claims Data API (BCDA)
CMS AB2D API (Claims Data to Part D Sponsors)
CMS Data at the Point of Care (DPC) API
CMS Finder API
CMS Quality Payment Program (QPP) Submissions API
Centers for Medicare and Medicaid Services API Reference API
Centers for Medicare and Medicaid Services Code Search API
Centers for Medicare and Medicaid Services Cost Search API
Centers for Medicare and Medicaid Services Enrollments API
Centers for Medicare and Medicaid Services Geography API
Centers for Medicare and Medicaid Services Households & Eligibility API
Centers for Medicare and Medicaid Services Insurance Issuers API