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

# Exports

> Export HSI and Lab data in batch as downloadable archives from the Synheart Platform

The **Exports** page lets you export HSI and Lab data in batch as downloadable archives. Large exports run in the background, so you can start one and come back to download it later.

Open it from the sidebar: **Exports**. The page subtitle reads *"Export HSI and Lab data in batch as downloadable archives."*

<Note>
  Exports need a selected **organization** and **tenant**. Without both you'll see *"Select an organization and tenant to view and create exports."*
</Note>

<Warning>
  Export archives **expire after a limited time**. Download them promptly. Once an archive expires you'll need to run the export again.
</Warning>

## Permissions

Creating exports requires the `data.exports.create` permission. Without it you'll see *"You don't have permission to create exports. Ask an organization or tenant admin."* You can still view existing exports.

***

## Create an export

Click **New export** to open the **Export data** dialog (*"Export HSI and Lab data as a downloadable archive. Large exports run in the background. Track progress and download from the Exports page."*).

| Form field          | Description                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------- |
| **Scope**           | What to export: **Current tenant**, **A project**, **An app**, or **Entire organization** |
| **Project**         | The project to export (when scope is a project or app)                                    |
| **Apps**            | One or more apps (when scope is an app)                                                   |
| **From** (optional) | Start of the date range                                                                   |
| **To** (optional)   | End of the date range                                                                     |
| **Format**          | **NDJSON (recommended, lossless)**, **CSV (flattened, analyst-friendly)**, or **Both**    |

Click **Start export**. The job appears in the table and updates its progress automatically while running.

<Tip>
  Choose **NDJSON** for a lossless, machine-readable archive, or **CSV** for a flattened, spreadsheet-friendly version. Pick **Both** when you want each. (NDJSON is newline-delimited JSON, not a single JSON document.)
</Tip>

<Note>
  [Research studies](/platform/studies) reuse this same dialog from a cohort's **Export** action, pre-scoped to the study (and optionally a single participant).
</Note>

***

## Track and download exports

The exports table lists every export job with its scope, the time it was created, current status, row count, archive size, format, and a download link once it's ready.

Export status moves through four stages: **Pending** (queued and waiting to start), **Running** (actively processing, with a progress percentage), **Done** (archive ready to download), and **Failed** (shows an error message explaining what went wrong).

The **Rows** column shows the total record count across HSI and Lab data once an export finishes. The **Download** link becomes active when the status reaches **Done**. Click it to retrieve the archive before it expires.

Use **Refresh** to update the list manually; running jobs also poll automatically.

***

## Next

<CardGroup cols={2}>
  <Card title="Research studies" icon="flask" href="/platform/studies">
    Export cohort and participant data scoped to a study.
  </Card>

  <Card title="Connect & view data" icon="route" href="/platform/connect-and-view-data">
    Inspect individual sessions before exporting in bulk.
  </Card>

  <Card title="Billing & usage" icon="credit-card" href="/platform/billing">
    See how ingestion and storage usage maps to exportable data.
  </Card>
</CardGroup>