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

List disk space for rent as a volume on a machine.

## Signature

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

## Parameters

<ParamField path="id" type="int" required>
  id
</ParamField>

<ParamField path="price_disk" type="float" default="0.1">
  price\_disk
</ParamField>

<ParamField path="end_date" type="Optional[str]">
  end\_date
</ParamField>

<ParamField path="size" type="int" default="15">
  size
</ParamField>

## Returns

`str`, Result from the API call.

## Example

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

client = VastAI(api_key="YOUR_API_KEY")
result = client.list_volume(id=12345)
print(result)
```