> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-host-2752-sla-api-documentation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VastAI.list_machine

Lists a machine for rent with optional pricing and configuration parameters.

<Note>This is a **host** method, used for managing machines you are renting out on Vast.ai.</Note>

<Note>
  SLA listing parameters are not in the published Python SDK yet — prefer console **Set Pricing → SLA**, or REST; see [SLA Offers](/host/sla-offers#api-for-automation). Volume/duration listing options are CLI-only today.
</Note>

## Signature

```python theme={null}
VastAI.list_machine(
    id: 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

<ParamField path="id" type="int" required>
  Machine ID to list.
</ParamField>

<ParamField path="price_gpu" type="Optional[float]">
  GPU rental price in \$/hour for active instances.
</ParamField>

<ParamField path="price_disk" type="Optional[float]">
  Storage price in \$/GB/month for inactive instances.
</ParamField>

<ParamField path="price_inetu" type="Optional[float]">
  Upload bandwidth price in \$/GB.
</ParamField>

<ParamField path="price_inetd" type="Optional[float]">
  Download bandwidth price in \$/GB.
</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]">
  Minimum GPUs that must be rented together (GPU slicing).
</ParamField>

<ParamField path="end_date" type="Optional[str]">
  Offer expiration (Unix timestamp or MM/DD/YYYY).
</ParamField>

## Returns

`str`, Result from the API call.

## Example

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

client = VastAI(api_key="YOUR_API_KEY")
# Base listing only — for SLA, use the console or REST create_asks after list_machine()
# see SLA Offers → API (for automation): /host/sla-offers#api-for-automation
result = client.list_machine(id=12345, price_gpu=3.50, end_date="01/01/2030")
print(result)
```