> ## Documentation Index
> Fetch the complete documentation index at: https://support.mdreasoning.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Export patient data

> Download a ZIP of patient documents for a list of patients, choosing the document types and the date range to include.

Use **Patient Data Export** to download the documents of many patients in one ZIP file. You choose which patients, which kinds of documents and which dates. MD Reasoning refreshes each patient's latest records first, then packages their documents.

Open the **Bulk** page and choose **Patient Data Export**. It has two tabs: **Export** and **History**.

## Run an export

**1. Choose your patients**

Under **Patients from**, pick one of two ways to build the list. You can also add people one
by one with **Find patients**, and combine both.

**2. Check the matches**

Each person is matched against your organization's patients. Fix or remove any that did not
match (see below).

**3. Choose the documents**

Pick the **Document types** and the **Date range** to include.

**4. Start the export**

Press **Start export**. You can leave the page while it runs and come back to it from
**History**.

**5. Download the ZIP**

When the export finishes, press the download button to get your ZIP.

### Build the patient list

| Option | How it works |
| - | - |
| **Upload file** | Upload a roster as PDF, CSV, XLS or XLSX (up to 10 MB). Press **Extract Patients** and we read each name and date of birth |
| **From schedule** | Set **Appointment from** and **Appointment to**, then press **Load patients**. Everyone with an appointment in that range is added once, at their latest visit |
| **Find patients** | Search your organization by name, date of birth or patient number and press **Add** next to each person |

Skip the roster if you only want to add patients by search.

### Check the matches

After you build the list, patients are grouped:

| Section | What it means | What you do |
| - | - | - |
| **Matched patients** | These patients will be included when you start the export | Nothing. If several people match the same name and date of birth, choose the correct one before continuing |
| **Unable to find these patients** | No patient in your organization matched | Correct the name or date of birth, or remove the row |

### Choose document types

Under **Document types**, select the kinds of documents to include.

| Type |
| - |
| Labs, Pathology |
| X-ray, CT, MRI, Ultrasound, Other imaging |
| Cardiac tests, Procedures |
| Progress note, Hospital & consult notes, Other docs |

* Use **Select all** and **Clear all** to change the whole selection at once.
* When you select types, the ZIP has a folder for each patient, with a sub-folder for each document type.
* When you select no types, every document is exported, and the ZIP has one folder per patient with no sub-folders.
* Documents without a type (such as medications and immunizations) are only included when no types are selected.

### Choose a date range

Under **Date range**, only documents dated within the window are included.

| Option | Documents included |
| - | - |
| **Since Jan 1, 2025** | From that date onward |
| **This year** | From the start of the year |
| **Last 6 months** | The last six months |
| **All dates** | No date limit |
| **Custom** | The dates you enter |

## While the export runs

The export goes through three steps, shown on the page.

| Step | What happens |
| - | - |
| **Refresh latest records** | We update each matched patient's records so the ZIP has the latest documents |
| **Build document ZIP** | Each patient's documents are collected and packed into one ZIP |
| **Ready to download** | The ZIP is ready; it also appears under **History** |

Large lists can take 20 minutes or longer. You can leave the page, because the export keeps running and stays listed in **History**. Press **Check status** to refresh the page.

## Download earlier exports

The **History** tab lists finished and running exports for your organization. Open an export to download the ZIP again, or the original roster you uploaded.

## If an export does not finish

| Message | What it means |
| - | - |
| **Something went wrong while refreshing records or building the ZIP.** | The export stopped. Start another export to try again |
| **No patient's records could be refreshed. The ZIP only has documents already on file.** | The refresh did not work for any patient, so the ZIP only holds what was already stored |
| **The ZIP couldn't be built.** | No ZIP was created. Start another export |

When an export finishes, the page shows how many patients completed, for example "19 of 20 patients done".

## Related

* [Upload documents in bulk](https://support.mdreasoning.com/guides/bulk-upload.md)
* [Upload documents by email](https://support.mdreasoning.com/guides/email-upload.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.