> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-host-2752-sla-api-documentation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai list machine

> Host command

Lists a machine for rent.

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

<Note>
  SLA listing flags are not in the published CLI yet — prefer console **Set Pricing → SLA**, or REST; see [SLA Offers](/host/sla-offers#api-for-automation). Volume/duration options (`-v`, `-z`, `-l`) work today.
</Note>

## Usage

```bash theme={null}
vastai list machine ID [options]
```

## Arguments

<ParamField path="id" type="integer" required>
  ID of the machine to list.
</ParamField>

## Options

<ParamField path="-g" type="number">
  per gpu rental price in \$/hour  (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

Performs the same action as pressing the "LIST" button on the site [https://cloud.vast.ai/host/machines](https://cloud.vast.ai/host/machines).
On the end date, the listing will expire and your machine will unlist. However, any existing rental contracts will still remain until ended by their owners.
Once you list your machine and it is rented, it is extremely important that you don't interfere with the machine in any way.
If your machine has an active rental contract and then goes offline, crashes, or has performance problems, this can lower your marketplace reliability score (it recovers with continued good uptime — see [Hosting overview](/host/hosting-overview#why-did-the-reliability-on-my-machine-decrease)).
We strongly recommend you test the machine first and only list when ready. Always set an offer end date (`-e`) for SLA listings — see [Offer End Date](/host/hosting-overview#offer-end-date) and [SLA Offers](/host/sla-offers).

## Examples

```bash theme={null}
vastai list machine <ID> -g 3.50 -e "01/01/2030"
```

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