---
name: metabase_list_notifications
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_list_notifications(client: MetabaseClient, card_id: int = 0, dashboard_id: int = 0) -> list[dict]"
description: "Lista notificaciones de Metabase (alertas y suscripciones). Filtra opcionalmente por card_id o dashboard_id. Endpoint: GET /api/notification."
tags: [metabase, notification, list, api, python, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: client
    desc: "instancia autenticada de MetabaseClient"
  - name: card_id
    desc: "si > 0, filtra alertas de tipo notification/card asociadas a esta card"
  - name: dashboard_id
    desc: "si > 0, filtra suscripciones de tipo notification/dashboard asociadas a este dashboard"
output: "list[dict]: lista de notificaciones con id, active, payload_type, payload, subscriptions, handlers, created_at, updated_at"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/notifications.py"
---

## Ejemplo

```python
# Todas las notificaciones
notifs = metabase_list_notifications(client)

# Solo alertas de una card especifica
alerts = metabase_list_notifications(client, card_id=7711)
for a in alerts:
    print(a["id"], a["payload_type"], a["active"])

# Solo suscripciones de un dashboard
subs = metabase_list_notifications(client, dashboard_id=42)
```

## Notas

Requiere Metabase 0.57+. En versiones anteriores usar /api/pulse (deprecado).
Sin filtros retorna todas las notificaciones accesibles por el usuario autenticado.
