Medicare Blue Button: Medicare claims in one place

Medicare Blue Button is Medicare's optional way to download your claims or share them with an app you authorize at Medicare.gov. Connected apps can receive Part A, Part B, and Part D claims. That feed shows billed services and coverage. It is not your clinic's complete visit notes.

CMS's Blue Button API delivers Medicare claims data through three FHIR resources. Patient covers demographics and identifiers. Coverage covers insurance enrollment, including dual coverage. ExplanationOfBenefit is the main claims feed: where and when a service happened, diagnosis codes, the provider on the claim, and cost of care. On the claim side, CMS maps inpatient, outpatient, skilled nursing, hospice, home health, professional (carrier), durable medical equipment, and Part D prescription drug events when those claims are in Medicare's files. Medicare.gov also says you can download claims to a device, or link a connected app, and stop sharing in your Medicare account at any time.

No. Claims show what was billed and how coverage applied. They are not the same as a clinic's visit notes, nursing notes, or the fuller chart a hospital keeps. HIPAA still gives you a separate right to inspect and copy medical and billing records held by covered providers and plans. A patient portal at one health system (for example MyChart) shows that system's everyday slice. Provider record search through Triangle reaches what participating providers return. Uploads cover PDFs and scans you already hold. Medicare Blue Button sits beside those paths for Medicare claims. It does not replace them. For the portal versus designated-record-set line, see Patient portal vs full medical record (/answers/patient-portal-vs-full-medical-record). For the copy request itself, see Getting your medical records (/answers/getting-your-medical-records) and HIPAA right of access (/answers/hipaa-right-of-access).

Medicare.gov is blunt here. If you have a Medicare Advantage Plan, the Medicare.gov Blue Button data will only include claims for your drugs. Medical Part A and Part B style claims for care paid by the Advantage plan are not in that same Medicare.gov feed. Medicare.gov also says you can check with your plan to find out whether it offers apps that let you access and share your health data. You could avoid assuming Blue Button pulled every Advantage claim or every clinical document. Claims success still is not a complete chart.

At a high level: create a Medicare account if you do not have one, pick a connected app, sign up with that app, and give it access to your data through Medicare's authorization flow. CMS Blue Button uses OAuth 2.0, and access is per person. Your choice during authorization sets the scope the app receives. You can omit some personal fields such as name, date of birth, race, and sex when you grant access. You can log into your Medicare account later and stop sharing with an app. Downloaded files are worth treating like banking information. Medicare.gov also notes that caregivers and others you trust are among the people you might share claims with through connected apps. Caregiver access to medical records (/answers/caregiver-access-to-medical-records) covers personal-representative rights when someone needs the fuller chart, which is a different legal path.

A green connection is not the same as a finished import. CMS pulls claims into the Blue Button API from Medicare's Chronic Conditions Warehouse on a weekly cycle, and that pull can lag for maintenance or because claims themselves arrive late. Fresh claims often take time to show. What you authorized also matters. During Medicare.gov authorization you choose the scope of access. In Triangle, you also choose sync settings and claim groups before the first pull, so the first import follows those choices rather than every claim type CMS could ever return. Hospital, medical outpatient, and prescription groups appear only where CMS makes them available for your coverage. If a recent hospital stay is still not listed, wait for the next claims update, confirm the claim group was selected, and remember that visit notes live in the clinic chart, not in the claims feed. When you need the clinic's documents for a new doctor, Sharing medical records with a new doctor (/answers/sharing-medical-records-with-a-new-doctor) covers directed send and access requests.

Think in lanes, not one magic file. A patient portal such as MyChart is usually one health system's window: labs, visit summaries, messages for that system. Blue Button is a Medicare claims path from Medicare.gov. Provider record search asks participating hospitals and clinics for the records they hold. Upload is for files you already have. Blue Button helps when you want Medicare claim history in one place. It will not fill every gap a portal leaves, and a portal will not substitute for Medicare claims. For portal limits, see Patient portal vs full medical record (/answers/patient-portal-vs-full-medical-record). For requesting copies under HIPAA, see Getting your medical records (/answers/getting-your-medical-records).

Triangle's app has a Medicare path at /medicare where you can learn how Blue Button connect works. Availability can be gated, so treat that screen as how-it-works guidance until Connect is clearly open for your account. The product pattern is: you authorize at Medicare.gov, Triangle stores encrypted credentials, and you choose sync settings and claim groups before the first pull. What arrives is Medicare Patient, Coverage, and ExplanationOfBenefit data where CMS supplies it for your coverage, plus the claim groups you selected. Connection success does not mean every claim is already in. Claims still are not a complete clinical chart. Triangle can sit those claims beside records from participating providers and files you upload, so you can see what arrived before the next visit. It does not diagnose, and your care team still needs to read the file.