> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai list machines

> Host command

list machines for rent

<Note>This is a **host** command, used for managing machines you are renting out on Vast.ai.</Note>

## Usage

```bash theme={null}
vastai list machines IDs [options]
```

## Arguments

<ParamField path="ids" type="integer" required>
  ids of instance to list
</ParamField>

## Options

<ParamField path="-g" type="number">
  per gpu on-demand rental price in \$/hour (base price for active instances) (alias: `--price_gpu`)
</ParamField>

<ParamField path="-s" type="number">
  storage price in \$/GB/month (price for inactive instances), default: \$0.10/GB/month (alias: `--price_disk`)
</ParamField>

<ParamField path="-u" type="number">
  price for internet upload bandwidth in \$/GB (alias: `--price_inetu`)
</ParamField>

<ParamField path="-d" type="number">
  price for internet download bandwidth in \$/GB (alias: `--price_inetd`)
</ParamField>

<ParamField path="-b" type="number">
  per gpu minimum bid price floor in \$/hour (alias: `--price_min_bid`)
</ParamField>

<ParamField path="-r" type="number">
  Max long term prepay discount rate fraction, default: 0.4  (alias: `--discount_rate`)
</ParamField>

<ParamField path="-m" type="integer">
  minimum amount of gpus (alias: `--min_chunk`)
</ParamField>

<ParamField path="-e" type="string">
  contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format) (alias: `--end_date`)
</ParamField>

<ParamField path="-l" type="string">
  Updates end\_date daily to be duration from current date. Cannot be combined with end\_date. Format is: `n days`, `n weeks`, `n months`, `n years`, or total intended duration in seconds. (alias: `--duration`)
</ParamField>

<ParamField path="-v" type="integer">
  Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer. (alias: `--vol_size`)
</ParamField>

<ParamField path="-z" type="number">
  Price for disk on volume contract offer. Defaults to price\_disk. Invalid if vol\_size is 0. (alias: `--vol_price`)
</ParamField>

## Description

This variant can be used to list or update the listings for multiple machines at once with the same args.
You could extend the end dates of all your machines using a command combo like this:
./vast.py list machines \$(./vast.py show machines -q) -e 12/31/2024 `--retry` 6

## Examples

```bash theme={null}
vastai list machines <IDS>
```

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