> ## 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.list_volumes

List disk space for rent as volumes on multiple machines.

## Signature

```python theme={null}
VastAI.list_volumes(
    ids: Any,
    price_disk: Optional[float] = 0.1,
    end_date: Optional[str] = None,
    size: Optional[str] = 15
) -> dict
```

## Parameters

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

<ParamField path="price_disk" type="Optional[float]" default="0.1">
  storage price in $/GB/month, default: $%(default).2f/GB/month
</ParamField>

<ParamField path="end_date" type="Optional[str]">
  contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format), default 3 months
</ParamField>

<ParamField path="size" type="Optional[str]" default="15">
  size of disk space allocated to offer in GB, default %(default)s GB
</ParamField>

## Returns

`dict`

## Example

```python theme={null}
from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.list_volumes(ids="value")
print(result)
```