# ath records

> Find stable record IDs and inspect revision history.

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

ATH v1.0.0 · MIT license. Documentation source: [7cd6a09](https://github.com/mwhitham/ath/blob/7cd6a097dbf2a12c7ea8a319869d4e0bb0def96b/src/program.ts). If your installed version differs, check its command help.

Checked 18 October 2026: v1.0.0 is available on npm.

## Usage

```text
ath records list
ath records show <record-id> --history --links
```

## ath records list

Lists current records in stable order. Filter by record type, include normally deleted records, and set a bounded result limit.

| Argument or option | Description |
| --- | --- |
| `--type <record-type>` | show one record type |
| `--include-deleted` | include records hidden by normal deletion |
| `--limit <count>` | maximum records, default 100 |
| `--file <path>` | read another database |
| `--json` | structured output |

## ath records show

Shows one stable UUIDv7 record. Select a retained revision, include its complete history, or inspect incoming and outgoing links.

| Argument or option | Description |
| --- | --- |
| `--revision <number>` | show one retained revision |
| `--history` | include the revision timeline |
| `--links` | include incoming and outgoing record links |
| `--file <path>` | read another database |
| `--json` | structured output |

## Related commands

- [ath correct](https://ath.fit/docs/correct/)
- [ath delete](https://ath.fit/docs/delete/)
- [ath erase](https://ath.fit/docs/erase/)