Skip to main content
List instances with filtering, sorting, and pagination

Usage

vastai show instances-v1 [OPTIONS]

Options

--quiet
boolean
only print instance IDs, one per line
--verbose
boolean
show additional columns (SSH, location, template, etc.)
--all
boolean
fetch all pages automatically; useful for scripting
--status
string
filter by container status: running loading exited
--label
string
filter by instance label; pass empty string ” for unlabeled
--gpu-name
string
filter by GPU model name
--verification
string
filter by verification status Allowed values: verified, unverified, deverified
--limit
integer
default:"25"
max instances per page (1-25, default 25)
--next-token
string
resume from a pagination token
--order-by
string
sort by column; repeat for multiple keys
--cols
string
override displayed columns (available: id,status,label,gpu,disk,volumes,dph,image,age,verified,machine,net,location,template,ssh,msg)

Description

Displays your instances in a table with auto-sizing columns. Narrow terminals drop lower-priority columns automatically; use —cols to override.

Examples

vastai show instances-v1
    vastai show instances-v1 -v
    vastai show instances-v1 --status running loading
    vastai show instances-v1 --gpu-name 'RTX A5000' 'GTX 1070'
    vastai show instances-v1 --label training --order-by start_date desc
    vastai show instances-v1 --cols id,status,gpu,dph
    vastai show instances-v1 --next-token eyJ2YWx1ZXMi...

Global Options

The following options are available for all commands:
OptionDescription
--url URLServer REST API URL
--retry NRetry limit
--rawOutput machine-readable JSON
--explainVerbose explanation of API calls
--api-key KEYAPI key (defaults to ~/.config/vastai/vast_api_key)