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

List disk space for rent as a volume.

## Signature

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

## Parameters

<ParamField path="id" type="int" required>
  id of machine to 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_volume(id=12345)
print(result)
```