> ## 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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.