The Blue Button API contains four years of Medicare Part A, B and D data for 53 million Medicare beneficiaries. This data reveals a variety of information about a beneficiary’s health, including type of Medicare coverage, drug prescriptions, primary care treatment and cost. Beneficiaries also have full control over how their data can be used and by whom, with identity and authorization controlled by MyMedicare.gov.

The Blue Button API uses the HL7 FHIR standard for beneficiary data and the OAuth 2.0 standard for beneficiary authorization.

Getting started

Documentation for the Blue Button API is available in the Blue Button developer portal. View API Documentation

CMS is inviting developers to provide feedback on the new CMS Blue Button API for the purpose of improved development. Join the Developer Preview

Participants in the Developer Preview can register an application and build integrations with their software using synthetic claims data. Register an application

Value and Use Cases

Developers integrate with the Blue Button API adding value for beneficiaries, providers, care organizations, researchers and many more across Healthcare and Life Sciences to:

Reduce patient burden

A research organization can pre-populate a medication lists for a patient during clinical trial enrollment.

Streamline information about different kinds of care over time

A primary care physician can access information on other patient care (e.g. related to behavioral health) to better inform treatment.

Uncover new insights that can improve health outcomes

A pharmacy can determine if a beneficiary gets healthier over time due to medication adherence.

Access and monitor health information in one place

A health application can aggregate data into a health dashboard for beneficiaries.


The Blue Button API Google Group is where developers can ask questions, find answers, leave feedback and share experiences using the Blue Button API. Visit the Blue Button Google Group.

Back to top