MyChart / FHIR Connection

HealthViewer can connect directly to your health system’s patient portal using the FHIR standard, pulling lab results without needing a PDF at all.

Supported Systems

Any health system that exposes a FHIR R4 endpoint with patient access works. This includes most major US health networks using Epic (MyChart) or Cerner, and practices using athenahealth or eClinicalWorks once the practice has enabled HealthViewer.

How to Connect

1. Click Import → Connect Health System
2. Search for your health system by name or browse the list
3. Under Results to fetch, choose how far back to go: all available results, the last 12 months, or from a date you pick
4. Click Connect. Your browser opens your health system’s login page
5. Sign in with your patient portal credentials and authorize HealthViewer to read your health records
6. Review the results before anything is saved (see below), then click Import

Reviewing Results Before Import

HealthViewer shows every result it fetched, grouped by date, before saving anything:

• New results are selected.
• Results you already have, for example from a PDF you uploaded earlier, are marked Already in HealthViewer and are not selected, so importing won’t create duplicates. You can select one if you want a second copy anyway.
• Untick anything you don’t want, or use Clear selection and pick results one by one.

A result counts as one you already have when it’s the same test, on the same day, with the same value. A PDF sometimes shows the report date where your health system shows the collection date. Those results land on different days and won’t be marked, so look over results from around the same dates as PDFs you’ve uploaded.

What Gets Imported

• Lab results (Observations) with values, units, and reference ranges
• Result dates
• Panel/order names where available

Medications, conditions, and other clinical data are not imported in the current version.

If any imported results are missing a unit or reference range, a notice after the import says how many. Click Review to fix them in the Test Catalog.

Authorization & Privacy

• HealthViewer uses OAuth 2.0 — your portal password is never seen or stored by HealthViewer
• Authorization tokens are stored encrypted in your local .hvdb file
• Tokens are used only to fetch your data; HealthViewer makes no other requests to your health system
• You can revoke HealthViewer’s access at any time through your patient portal’s connected apps settings

Refreshing Data

To pick up new results, go to Import → Connect Health System and choose your health system under Recent connections. Results to fetch defaults to Since last import, which starts 30 days before your last import so results posted late are still included. Anything you already have is marked in the review, so the overlap doesn’t create duplicates.

Cleaning Up Duplicates

The review catches results with the same date. A PDF sometimes dates results by the report date while your health system uses the collection date, so the same result can end up in HealthViewer twice, a day or two apart. To find and remove these:

1. Go to Settings → Data → Duplicate Results and click Find duplicates. Results without a date aren’t checked.
2. Each set lists the copies of one result: the same test with the same value, up to 3 days apart. A set is selected when its copies share a date, or come from different kinds of import (for example a PDF and your health system) with the same value, allowing for unit conversion.
3. Other sets with copies on different days, including results you entered by hand, are left unselected, since they may be real repeat tests. Check them under To check and select any that are duplicates.
4. Keep marks the copy that stays. It’s chosen by source (health-system data first), then by which copy has a reference range. Choose another copy if you prefer. Missing units, reference ranges, lab codes and notes are copied onto the kept result. If it had no Normal/Abnormal flag of its own, one is worked out from the copied range, or taken from a removed copy that reports exactly the same value.
5. Click Remove to remove the other copies. Custom reports that listed a removed copy are updated to show the kept one. The original reports and uploaded files stay in HealthViewer.

Troubleshooting

My health system isn’t listed Try searching by hospital name, city, or parent network. If still not found, your health system may not expose a public FHIR endpoint. Use the PDF upload path instead.

Authorization fails or times out Make sure you’re using your patient portal credentials (not employee/provider credentials). Some systems require you to have an active MyChart account — register at your health system’s patient portal first.

eClinicalWorks or athenahealth: “not enabled” or authorization fails These vendors require each practice to turn on patient apps before you can connect. In HealthViewer, click Copy request for your practice and send it to your provider’s office, for example as a portal message. It links to the setup steps for their administrator: eClinicalWorks or athenahealth. You’ll also need an active healow or athenahealth Patient Portal account.

Results are missing or incomplete FHIR availability varies by health system. Some labs may only be available in older PDF exports. Try downloading a PDF from your portal and uploading it to capture any gaps.