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

List disk space for rent as volumes on multiple machines.

## Signature

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

## Parameters

<ParamField path="ids" type="List[int]" required>
  ids
</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_volumes(ids=[12345])
print(result)
```