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

> Host command

list disk space for rent as a volume on machines

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

## Usage

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

## Arguments

<ParamField path="ids" type="integer" required>
  id of machines list
</ParamField>

## Options

<ParamField path="-p" type="number" default="0.1">
  storage price in \$/GB/month, default: \$0.1/GB/month (alias: `--price_disk`)
</ParamField>

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

<ParamField path="-s" type="string" default="15">
  size of disk space allocated to offer in GB, default 15 GB (alias: `--size`)
</ParamField>

## Description

Allocates a section of disk on machines to be used for volumes.

## Examples

```bash theme={null}
vastai list volumes <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`) |