vastai show instances

Display user’s current instances

Usage

vastai show instances [OPTIONS]

Options

--quiet · boolean

only display numeric ids

--verbose · boolean

show additional columns (SSH, location, template, etc.)

--all · boolean

force fetching every page before printing, even with —limit/—next-token (fetching everything is already the default otherwise)

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

max instances per page (1-25); passing this switches to single-page mode instead of fetching everything

--next-token · string

resume from a pagination token (implies single-page mode)

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

Shows the instances the user is currently renting. By default this fetches every page and prints one combined result, which is safe for scripts and cron jobs. Passing —limit or —next-token switches to single-page mode for manual pagination (add —all to still fetch every page in that mode).

Examples

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

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)