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

List multiple machines for rent.

## Signature

```python theme={null}
VastAI.list_machines(
    ids: Any,
    price_gpu: Optional[float] = None,
    price_disk: Optional[float] = None,
    price_inetu: Optional[float] = None,
    price_inetd: Optional[float] = None,
    price_min_bid: Optional[float] = None,
    discount_rate: Optional[float] = None,
    min_chunk: Optional[int] = 1,
    end_date: Optional[str] = None,
    duration: Optional[str] = None,
    vol_size: Optional[int] = None,
    vol_price: Optional[float] = None
) -> list[dict]
```

## Parameters

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

<ParamField path="price_gpu" type="Optional[float]">
  per gpu on-demand rental price in \$/hour (base price for active instances)
</ParamField>

<ParamField path="price_disk" type="Optional[float]">
  storage price in $/GB/month (price for inactive instances), default: $0.10/GB/month
</ParamField>

<ParamField path="price_inetu" type="Optional[float]">
  price for internet upload bandwidth in \$/GB
</ParamField>

<ParamField path="price_inetd" type="Optional[float]">
  price for internet download bandwidth in \$/GB
</ParamField>

<ParamField path="price_min_bid" type="Optional[float]">
  per gpu minimum bid price floor in \$/hour
</ParamField>

<ParamField path="discount_rate" type="Optional[float]">
  Max long term prepay discount rate fraction, default: 0.4
</ParamField>

<ParamField path="min_chunk" type="Optional[int]" default="1">
  minimum amount of gpus (default: 1)
</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)
</ParamField>

<ParamField path="duration" type="Optional[str]">
  Updates end\_date daily to be duration from current date. Cannot be combined with end\_date. Format is: `n days`, `n weeks`, `n months`, `n years`, or total intended duration in seconds.
</ParamField>

<ParamField path="vol_size" type="Optional[int]">
  Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer.
</ParamField>

<ParamField path="vol_price" type="Optional[float]">
  Price for disk on volume contract offer. Defaults to price\_disk. Invalid if vol\_size is 0.
</ParamField>

## Returns

`list[dict]`

## Example

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

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