# ath import

> Load device exports into your record.

Website: https://ath.fit/docs/import/
Markdown: https://ath.fit/docs/import.md

ATH v0.4.3 · MIT license. Documentation source: [cd89f72](https://github.com/mwhitham/ath/blob/cd89f72eceae3961ef1a05694226515c9e4321d2/src/program.ts). If your installed version differs, check its command help.

Checked 27 September 2026: v0.4.3 is available on npm.

## Usage

```text
ath import ~/Downloads/export.zip
```

## Arguments

| Argument or option | Description |
| --- | --- |
| `<path>` | Required. ZIP, extracted export folder, export.xml or supported vendor CSV. |

## What it does

Detects Apple Health, WHOOP and Oura exports from a ZIP, extracted folder, Apple Health export.xml or supported vendor CSV. Adds measurements to the record and dense samples to series/. Re-importing the same export does not duplicate the same records.

## Examples

Export from the original device service when possible. Apple Health may not contain everything another wearable recorded. The import report lists what was added or skipped. ATH can offer to link previously logged results to sessions that arrive in the export.

```text
ath import ~/Downloads/export.zip --json
```

## Options

| Argument or option | Description |
| --- | --- |
| `--file <path>` | import into a file other than the one in this folder |
| `--json` | structured output, for an agent rather than a person |

## Related commands

- [ath stats](https://ath.fit/docs/stats/)
- [ath link](https://ath.fit/docs/link/)
- [ath check](https://ath.fit/docs/check/)