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

# basecut snapshot list

> List snapshots with filtering and cursor pagination

List snapshots for your user or organization.

## Usage

```bash theme={null}
basecut snapshot list [flags]
```

## Flags

| Flag                       | Default     | Description                                         |
| -------------------------- | ----------- | --------------------------------------------------- |
| `--limit <n>`              | `20`        | Number of snapshots to return per page (1-100).     |
| `--cursor <cursor>`        | none        | Cursor from a previous result page.                 |
| `--all`                    | `false`     | Fetch all pages automatically.                      |
| `--status <status>`        | none        | Filter by status: `READY`, `EXPIRED`, or `DELETED`. |
| `--name <name>`            | none        | Filter by snapshot name.                            |
| `--tag <tag>`              | none        | Filter by snapshot tag.                             |
| `--search <query>`         | none        | Search snapshot metadata.                           |
| `--source-host <host>`     | none        | Filter by source host.                              |
| `--source-database <name>` | none        | Filter by source database.                          |
| `--json`                   | `false`     | Output JSON instead of table format.                |
| `--profile <name>`         | `default`   | Credential profile for API auth.                    |
| `--api-key <key>`          | env/profile | API key override.                                   |

## Examples

```bash theme={null}
# List latest snapshots
basecut snapshot list

# Filter by name and status
basecut snapshot list --name dev-seed --status READY

# Continue from a cursor
basecut snapshot list --cursor "cursor_abc123"

# Fetch all pages
basecut snapshot list --all

# JSON output
basecut snapshot list --json
```