Skip to main content
CMS Blue Button 2.0
CMS Blue Button 2.0

Blue Button 2.0 API Blog


­Get Just the Claims Data You Need

The Blue Button 2.0 API team is excited to announce feature enhancements that will enable third-party partner applications to request only the claims data they need. These enhancements will allow apps to request certain claim types, such as Medicare Part D Pharmacy Claims (PDE), or only request new claims information since the last updated date.

Blue Button 2.0 API Update

12/27/2019 Update

Update – December 27, 2019: The Centers for Medicare & Medicaid Services (CMS) has conducted a full review of Blue Button 2.0, corrected the faulty code, implemented additional protections, and is resuming normal operations of the system.

The technical issue discovered on December 4th only impacted 30 authorized Blue Button 2.0 applications (apps). These apps will be able to reconnect to the Blue Button 2.0 API after providing CMS with written confirmation that they have implemented a plan to address incorrect data in their app. CMS has been working closely with app developers and appreciates their cooperation in resolving the matter as quickly as possible to ensure patient privacy is protected. If you have any questions, please reach out to

Ensuring Beneficiary Privacy and Security Through New Application Onboarding Requirements

As adoption of the Blue Button 2.0 API (BB2.0 API) grows, the CMS Blue Button 2.0 team continues to look at ways to improve the API and stay current with evolving standards. A primary goal for CMS with the BB2.0 API is to help beneficiaries make more informed choices about the applications they use and the data they share. To enhance the security and privacy posture for Medicare beneficiaries using the BB2.0 API, we are pleased to announce the following changes to our service:

Sandbox Users! We are Changing the Patient Identifier

On July 22nd, the Blue Button 2.0 team will make a change to apply a minus sign prefix to the Patient Identifier, the FHIR ID, in the patient records in our sandbox environment. This change will ensure that synthetic records are formatted the same way in both the sandbox and production environments.

List of Production Applications Integrated with Blue Button 2.0 Now on

On Tuesday, February 12th at HIMSS19, CMS Administrator Seema Verma announced the publication of the list of the production applications connected to the Blue Button 2.0 API on – you can find the list at: This announcement demonstrates CMS’ ongoing commitment to MyHealthEData, a government-wide initiative to empower patients by giving them control of their healthcare data and allowing it to follow them through their healthcare journey.

BBDC18 Roadmap Q&A

Over the past several weeks the Blue Button 2.0 team had been reviewing feedback from our developer community about new features you would like to be added to the API.

Blue Button 2.0 Implementation Guide

The Blue Button 2.0 team is continually working to improve the Blue Button 2.0 API and the supporting documentation. When the API was announced at HIMSS in March 2018 it created a lot of interest. That interest came not just from developers wanting to connect to the API and work with the data it contains, but also from other organizations around the healthcare industry, such as insurers and Medicaid agencies. For the latter category of technologists there is significant interest in how The Blue Button 2.0 team built the Fast Healthcare Interoperability Resource (FHIR) records that hold the beneficiaries’ data.

Install a Node.js Application

As we prepared to launch our Production Blue Button 2.0 API we wanted to test the API from the perspective of a third-party client application.