# Read the detail.

> An overview when you need orientation. Individual samples when you need evidence.

Website: https://ath.fit/docs/read/
Markdown: https://ath.fit/docs/read.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.

## Start with the overview

See the available measurements, date coverage, per-source averages and benchmark history. Coverage matters as much as the number itself.

```text
ath stats
```

## Inspect a measurement

A series prints one summary row per day. Filter a date range, select one source, or use --raw for individual samples.

```text
ath series heart_rate
ath series heart_rate --from 2026-08-24 --to 2026-08-30
ath series heart_rate --source apple-watch-1 --raw
```

## Pass it to an agent

Use --json for structured output. Use the actual source IDs shown by ath stats; the source above is an example.

```text
ath stats --json
ath series heart_rate --json
```