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

Retrieve and display a list of machines based on specified criteria.

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

## Signature

```python theme={null}
VastAI.show_machines(quiet: bool = False, filter: Optional[str] = None) -> str
```

## Parameters

<ParamField path="quiet" type="bool" default="False">
  If True, limit the output to minimal details such as IDs.
</ParamField>

<ParamField path="filter" type="Optional[str]">
  A string used to filter the machines based on specific criteria.
</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.show_machines()
print(result)
```