vastai show instances-v1

Show instances with pagination and filtering (v1).

Usage

vastai show instances-v1 [OPTIONS]

Options

-q · boolean

Only print instance IDs, one per line (alias: --quiet)

-v · boolean

Show additional columns (SSH, location, template, etc.) (alias: --verbose)

-a · boolean

Fetch all pages automatically and send to pager (alias: --all)

--status · string

Filter by container status. Choices: running, loading, exited

--label · string

Filter by instance label; pass empty string to match unlabeled

--gpu-name · string

Filter by GPU model name (e.g. RTX A5000)

--verification · string

Filter by machine verification. Choices: verified, unverified, deverified

--limit · integer

Max instances per page (1–25, default 25)

--next-token · string

Resume from a pagination token from a previous page

--order-by · string

Sort column with optional direction, e.g. start_date desc

--cols · string

Override displayed columns with a comma-separated list

Description

Returns a paginated list of instance objects. Key status fields per instance:

actual_status — current container state:

Value	Meaning
null	Instance is being provisioned
loading	Docker image is downloading or container is starting up
running	Container is actively executing. GPU charges apply.
stopped	Container is halted. Disk charges continue; no GPU charges.
frozen	Container is paused with memory preserved. GPU charges apply.
exited	Container process exited unexpectedly
rebooting	Container is restarting (transient)
unknown	No recent heartbeat from the host
offline	Host machine disconnected from Vast servers (computed, not stored in DB)

intended_status — user’s desired target state: running, stopped, or frozen.

cur_state — machine contract / hardware allocation state: running, stopped, or unloaded (released on destroy).

status_msg — human-readable detail on the current status.

Examples

vastai show instances-v1

vastai show instances-v1 --status running --limit 10

vastai show instances-v1 --all --verbose

vastai show instances-v1 --next-token <token_from_previous_page>

Global Options

The following options are available for all commands:

Option	Description
--url URL	Server REST API URL
--retry N	Retry limit
--raw	Output machine-readable JSON
--explain	Verbose explanation of API calls
--api-key KEY	API key (defaults to ~/.config/vastai/vast_api_key)