> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawa-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Models

> List and retrieve Pawa AI models with the Python SDK.

Use `client.models` to discover available models and fetch a single model by ID. See the [Models API reference](/api-reference/endpoint/models/introduction) for response fields.

## List models

```python theme={null}
from pawa_ai import PawaAI

client = PawaAI()

models = client.models.list(limit=10)

print(models.success)
for model in models.models:
    print(f"{model.name} ({model.model_type})")
```

### Filter and paginate

```python theme={null}
models = client.models.list(
    search="ember",
    model_type="chat",
    page=1,
    limit=20,
)
```

### Raw JSON response

```python theme={null}
payload = client.models.list(limit=5, raw=True)
print(payload)
```

## Retrieve a model

```python theme={null}
from pawa_ai import PawaAI

client = PawaAI()

model = client.models.retrieve(model_id=1)

print(model.name)
print(model.model_type)
```

```python theme={null}
payload = client.models.retrieve(1, raw=True)
print(payload)
```