# snapdir revisions

List snapshot IDs created on a location (store or absolute path).

`revisions` prints the snapshot IDs the catalog has recorded for a given location
— a store URI or an absolute path — newest history first. See the
[History guide](../guide/history.md).

## Usage

```text
snapdir revisions [OPTIONS]
```

### Options

`revisions` takes no positional arguments. It accepts the
[global options](overview.md#global-options); the most relevant are `--location`
(the store or absolute path to query) and `--catalog`.

## Examples

List the revisions recorded on an absolute path:

```console
snapdir revisions --location /srv/project
```

List the revisions recorded on a store:

```console
snapdir revisions --location s3://my-bucket/snapshots
```

## See also

- [`snapdir ancestors`](snapdir-ancestors.md) — list a snapshot's ancestors
- [`snapdir locations`](snapdir-locations.md) — list known locations
- [History guide](../guide/history.md)