If your phone or another health app gives you a FHIR (.json) export - or you've downloaded an Apple Health export - Inciteful Med can read it.

What's a FHIR file?

FHIR (Fast Healthcare Interoperability Resources) is the modern standard for health data. Most US patient portals - and Apple Health when it's connected to a US health system through Health Records - can export your records as FHIR. The file is usually one or more .json (or .ndjson) files, sometimes packaged inside a .zip.

If your Apple Health export is just an XML file of your activity data (steps, heart rate, etc.) and not connected to a real patient portal, that's a different format and isn't currently supported as a clinical record import.

Upload visit summaries and labs as PDFs instead - see Uploading files.

Step-by-step

Open the patient profile that should receive the records.
Click Health Records and choose *Upload document.
Drag your .json or .zip file into the drop zone (or click to browse).

Import health data Image: FHIR import drop zone with a file being dragged onto it.

Reviewing the preview

Before anything is added to the patient's record, Inciteful Med shows you a preview of what's in the file:

How many patients the file contains
How many of each kind of record (labs, medications, problems, allergies, encounters, etc.)
A small sample of each so you can confirm the file is what you expected

If the file contains records for multiple people (common with family Apple Health exports), pick which patient(s) you want to import.

When the preview looks right, click Import. The import shows up as a single entry in your Recent Imports within a minute or two.

How imports show up in your records

A FHIR import is stored and listed as one item - the import job itself - even though it may contain dozens of underlying labs, medications, and visit notes. Inciteful Med uses everything in the bundle when answering questions, but you won't see a long list of individual lab/med records you can pick through.

This matters when you want to remove something: see "Re-importing or undoing" below.

How imports count toward your plan

An import counts as one record on your plan, however many labs, medications or visit notes it contains. The free Starter plan holds 3 records at a time; Personal and Family are unlimited. Records brought in automatically by a connected health system never count toward the limit.

See How record limits are counted.

Re-importing or undoing

Each import is tracked as a single job. If something went wrong - wrong patient selected, wrong file, wrong portal -scroll to the Recent Imports section of the Medical Data page, find the job, and click Revert. That removes the entire import in one step.

You cannot delete just a single record (a single lab value, a single medication) out of an import. The unit of removal is the whole import. If you need to fix a small piece, the workflow is:

Revert the import.
Re-import a corrected file.

See My import preview shows the wrong patient when an export contains records for more than one person.

Where to get a FHIR export

Apple Health (iPhone, with portals connected via Health Records): Open Health > tap your profile > Health Records > use the share option to export the connected health records.
Patient portal (US): Most portals expose a Download my data option that produces a FHIR export.
C-CDA file (XML, not JSON)? See Importing a C-CDA file.

Trouble importing?

Make sure the file is .json, .zip, or .ndjson. Other formats aren't recognized.
Very large exports (multi-year hospital systems) can take several minutes - leave the page open.
If the preview shows zero records, the file may be empty or the wrong format. Contact us and we'll help.