Skip to main content
List snapshots for your user or organization.

​
Usage

basecut snapshot list [flags]

​
Flags

FlagDefaultDescription
--limit <n>20Number of snapshots to return per page (1-100).
--cursor <cursor>noneCursor from a previous result page.
--allfalseFetch all pages automatically.
--status <status>noneFilter by status: READY, EXPIRED, or DELETED.
--name <name>noneFilter by snapshot name.
--tag <tag>noneFilter by snapshot tag.
--search <query>noneSearch snapshot metadata.
--source-host <host>noneFilter by source host.
--source-database <name>noneFilter by source database.
--jsonfalseOutput JSON instead of table format.
--profile <name>defaultCredential profile for API auth.
--api-key <key>env/profileAPI key override.

​
Examples

# 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