> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai show instances-v1

List instances with filtering, sorting, and pagination

## Usage

```bash theme={null}
vastai show instances-v1 [OPTIONS]
```

## Options

<ParamField path="--quiet" type="boolean">
  only print instance IDs, one per line
</ParamField>

<ParamField path="--verbose" type="boolean">
  show additional columns (SSH, location, template, etc.)
</ParamField>

<ParamField path="--all" type="boolean">
  fetch all pages automatically; useful for scripting
</ParamField>

<ParamField path="--status" type="string">
  filter by container status: running loading exited
</ParamField>

<ParamField path="--label" type="string">
  filter by instance label; pass empty string '' for unlabeled
</ParamField>

<ParamField path="--gpu-name" type="string">
  filter by GPU model name
</ParamField>

<ParamField path="--verification" type="string">
  filter by verification status
  Allowed values: verified, unverified, deverified
</ParamField>

<ParamField path="--limit" type="integer" default="25">
  max instances per page (1-25, default 25)
</ParamField>

<ParamField path="--next-token" type="string">
  resume from a pagination token
</ParamField>

<ParamField path="--order-by" type="string">
  sort by column; repeat for multiple keys
</ParamField>

<ParamField path="--cols" type="string">
  override displayed columns (available: id,status,label,gpu,disk,volumes,dph,image,age,verified,machine,net,location,template,ssh,msg)
</ParamField>

## Description

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

## Examples

```bash theme={null}
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:

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