---
name: metabase_list_users
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_list_users(client: MetabaseClient, status: str = '', query: str = '', limit: int = 0, offset: int = 0) -> dict"
description: "Lista usuarios de Metabase con filtros opcionales por estado, nombre/email y paginacion. Endpoint: GET /api/user."
tags: [metabase, user, list, api, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [httpx]
params:
  - name: client
    desc: "instancia autenticada de MetabaseClient"
  - name: status
    desc: "filtro por estado de usuario (active, deactivated, etc.)"
  - name: query
    desc: "búsqueda por nombre o email"
  - name: limit
    desc: "límite de resultados por página"
  - name: offset
    desc: "desplazamiento para paginación"
output: "dict: objeto paginado con data (usuarios), total, limit, offset"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/users.py"
---

## Ejemplo

```python
users = metabase_list_users(client, status="active", query="john@")
for u in users["data"]:
    print(u["email"], u["first_name"])
```

## Notas

Retorna dict paginado con data, total, limit, offset.
