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.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  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:
  - 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-userinfo-api
  name: CMS Blue Button 2.0 UserInfo 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
  properties:
  - type: OpenAPI
    url: openapi/cms-blue-button-userinfo-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
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com