Skip to main content

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites.

Explore the API

Test client

The Blue Button API test client is a quick, no-code-required way to explore data returned from our API endpoints.

Before you begin: If you’re logged in to the sandbox, log out to use the test client.

  1. Go to the Blue Button API test client.
  2. Choose a sample authorization token option. Click Authorize as a Beneficiary or Authorize as a Beneficiary (Spanish).
  3. Log in to Medicare.gov using a synthetic user’s account credentials.
  4. Click Connect.

Once you’re logged in as a Medicare enrollee, you’ll get an access token and you can make calls to different endpoints and see the sample data that is delivered in the response.

Sample data

If you want to see a sample of the data available in the Blue Button API without authenticating a synthetic user or creating a sandbox account, you can download a sample file. This zip folder of JSON files contains synthetic data for a single Medicare enrollee. The download includes 3 FHIR resources in JSON format:

  1. A single Patient resource
  2. A FHIR bundle containing multiple ExplanationOfBenefit resources (EOB)
  3. A FHIR bundle containing multiple Coverage resources

To learn more about Blue Button API data, refer to Understanding the Data.

bluebutton.cms.gov

official website of the U.S. Department of Health and Human Services and the Centers for Medicare & Medicaid Services.

Looking for U.S. government information and services?
Visit USA.gov