Skip to main content
List details of multiple machines with optional pricing and configuration parameters.
This is a host method, used for managing machines you are renting out on Vast.ai.

​
Signature

VastAI.list_machines(
    ids: List[int],
    price_gpu: Optional[float] = None,
    price_disk: Optional[float] = None,
    price_inetu: Optional[float] = None,
    price_inetd: Optional[float] = None,
    discount_rate: Optional[float] = None,
    min_chunk: Optional[int] = None,
    end_date: Optional[str] = None
) -> str

​
Parameters

​
ids
List[int]
required
ids
​
price_gpu
Optional[float]
price_gpu
​
price_disk
Optional[float]
price_disk
​
price_inetu
Optional[float]
price_inetu
​
price_inetd
Optional[float]
price_inetd
​
discount_rate
Optional[float]
discount_rate
​
min_chunk
Optional[int]
min_chunk
​
end_date
Optional[str]
end_date

​
Returns

str — Result from the API call.

​
Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.list_machines(ids=[12345])
print(result)