> ## Documentation Index
> Fetch the complete documentation index at: https://doc.trycapsule.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# capsule backup list

> List your cloud backups with short IDs for use with capsule download.

## Usage

```bash theme={null}
capsule backup list
capsule backup list --connection <label>
```

## What it does

Fetches all completed backups from your Capsule cloud storage and prints them with a short 10-character ID, connection name, size, and date.

```
  550e8400e2   my-postgres   1.2 MB   2026-07-01 02:00 UTC
  a3f91bc4d8   my-postgres   1.1 MB   2026-06-30 02:00 UTC
  ff02a19c71   my-mysql      840 KB   2026-06-29 03:00 UTC
```

Use the short ID with `capsule download` to download and decrypt a backup:

```bash theme={null}
capsule download 550e8400e2
```

## Flags

| Flag                 | Description                                                               |
| -------------------- | ------------------------------------------------------------------------- |
| `--connection`, `-c` | Filter the list to backups taken from a specific connection, by its label |

<Note>
  `--connection` filters by the connection the backup was **taken from**, not the one it was restored to. If you restored a backup to a different connection, that connection's name will not appear in the list — the backup is still listed under its original source connection.
</Note>

## About short IDs

Each backup is stored with a full UUID internally (e.g. `550e8400-e29b-41d4-a716-446655440000`). The list displays the first 10 hex characters without hyphens for convenience. Both formats are accepted by `capsule download` — you can also paste the full UUID if you have it.

If two backups happen to share the same short prefix (extremely unlikely), `capsule download` will tell you and ask you to provide more characters.

You can also copy a backup's short ID directly from the **Backups** page in the dashboard using the copy button next to each row.

## See also

* [`capsule download`](/cli/download) — download and decrypt a backup to a local file
* [`capsule restore`](/cli/backup-restore) — restore a database from a downloaded file