Read data / ATH documentation
ath series
Read daily summaries or individual measurement samples.
Usage
$ath series heart_rateArguments
What it does
Reads dense measurements from SQLite. The default output is one summary row per calendar day; --raw returns individual samples. It does not replace provider summaries or modify athlete data.
Examples
Choose a quantity and source ID found in ath stats. Date filters accept YYYY-MM-DD or an exact UTC timestamp. Calendar days use the saved athlete timezone or an explicit --timezone. Results are limited to 10,000 samples by default.
$ath series heart_rate --from 2026-08-24 --to 2026-08-30$ath series heart_rate --source apple-watch-1 --raw --json