CMS Blue Button 2.0

aid: cms-blue-button
url: https://raw.githubusercontent.com/api-evangelist/cms-blue-button/refs/heads/main/apis.yml
name: CMS Blue Button 2.0
kind: government
description: Blue Button 2.0 is the Centers for Medicare & Medicaid Services (CMS) API that lets Medicare beneficiaries share
  their Parts A, B, and D claims data with applications they trust. It is a FHIR R4 API conforming to the CARIN Blue Button
  Implementation Guide (CARIN Consumer Directed Payer Data Exchange), serving ExplanationOfBenefit, Patient, and Coverage
  resources for 60+ million people with Medicare. Access is patient-facing - each beneficiary authorizes an app through an
  OAuth 2.0 authorization-code flow (with mandatory PKCE) on Medicare.gov, choosing whether to share demographic data. A self-serve
  sandbox with synthetic enrollee data is open to everyone; production credentials are free but require CMS approval of the
  application.
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-11-13'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/cms-blue-button.png
tags:
- Blue Button
- CARIN
- Medicare
- FHIR
- Claims Data
- Patient Access
- Healthcare
- Government
created: '2026-07-11'
modified: '2026-07-11'
specificationVersion: '0.23'
apis:
- aid: cms-blue-button:cms-blue-button-coverage-api
  name: CMS Blue Button 2.0 Coverage API
  description: Medicare coverage resources, one per coverage type.
  humanURL: https://bluebutton.cms.gov/api-documentation/calling-the-api/
  baseURL: https://api.bluebutton.cms.gov/v2/fhir
  tags:
  - Coverage
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-coverage-api-openapi.yml
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/
  - type: APIReference
    url: https://bluebutton.cms.gov/data/understanding-the-data/
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/authorization/
- aid: cms-blue-button:cms-blue-button-explanationofbenefit-api
  name: CMS Blue Button 2.0 ExplanationOfBenefit API
  description: Medicare Parts A, B, and D claims as CARIN Blue Button EOB profiles.
  humanURL: https://bluebutton.cms.gov/api-documentation/calling-the-api/
  baseURL: https://api.bluebutton.cms.gov/v2/fhir
  tags:
  - ExplanationOfBenefit
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-explanationofbenefit-api-openapi.yml
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/
  - type: APIReference
    url: https://bluebutton.cms.gov/data/understanding-the-data/
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/authorization/
- aid: cms-blue-button:cms-blue-button-metadata-api
  name: CMS Blue Button 2.0 Metadata API
  description: FHIR capability statement.
  humanURL: https://bluebutton.cms.gov/api-documentation/calling-the-api/
  baseURL: https://api.bluebutton.cms.gov/v2/fhir
  tags:
  - Metadata
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-metadata-api-openapi.yml
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/
  - type: APIReference
    url: https://bluebutton.cms.gov/data/understanding-the-data/
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/authorization/
- aid: cms-blue-button:cms-blue-button-patient-api
  name: CMS Blue Button 2.0 Patient API
  description: Beneficiary demographic and administrative data.
  humanURL: https://bluebutton.cms.gov/api-documentation/calling-the-api/
  baseURL: https://api.bluebutton.cms.gov/v2/fhir
  tags:
  - Patients
  tags_raw:
  - Patient
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-patient-api-openapi.yml
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/
  - type: APIReference
    url: https://bluebutton.cms.gov/data/understanding-the-data/
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/authorization/
- aid: cms-blue-button:cms-blue-button-user-info-api
  name: CMS Blue Button 2.0 User Info API
  description: OpenID Connect userinfo for the authorizing beneficiary.
  humanURL: https://bluebutton.cms.gov/api-documentation/calling-the-api/
  baseURL: https://api.bluebutton.cms.gov/v2/fhir
  tags:
  - UserInfo
  tags_raw:
  - User Info
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-user-info-api-openapi.yml
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/
  - type: APIReference
    url: https://bluebutton.cms.gov/data/understanding-the-data/
  - type: Documentation
    url: https://bluebutton.cms.gov/api-documentation/authorization/
common:
- type: AgenticAccess
  url: agentic-access/cms-blue-button-agentic-access.yml
- type: DomainSecurity
  url: security/cms-blue-button-domain-security.yml
- type: Authentication
  url: authentication/cms-blue-button-authentication.yml
- type: Website
  url: https://bluebutton.cms.gov
- type: Documentation
  url: https://bluebutton.cms.gov/api-documentation/
- type: GitHubOrganization
  url: https://github.com/CMSgov
- type: Sandbox
  url: https://sandbox.bluebutton.cms.gov
- type: GettingStarted
  url: https://bluebutton.cms.gov/production-access/
- type: TermsOfService
  url: https://bluebutton.cms.gov/terms/
- type: Plans
  url: plans/cms-blue-button-plans-pricing.yml
- type: RateLimits
  url: rate-limits/cms-blue-button-rate-limits.yml
- type: FinOps
  url: finops/cms-blue-button-finops.yml
- type: UsageTerms
  url: terms/cms-blue-button-terms-of-service.yml
- type: Eligibility
  url: eligibility/cms-blue-button-eligibility.yml
- type: DataLicense
  url: data-license/cms-blue-button-data-license.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-parent: cms-gov
x-relationship: product