get
https://example.com/api/notifications/topics
Obtiene todos los tópicos disponibles para recibir notificaciones y permite filtrarlos por estado activo o paginación.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Consultá todos los tópicos disponibles para recibir notificaciones mediante webhooks.
Antes de empezar
- Usá este endpoint para conocer qué eventos podés suscribir a tus webhooks.
- Si querés limitar el resultado, usá los parámetros de paginación o filtrá por estado activo.
- Si necesitás el detalle de un tópico puntual, usá
GET /api/notifications/topics/{topic_id}.
Cómo consultar los tópicos disponibles
GET /api/notifications/topicsConsultar con paginación
GET /api/notifications/topics?page=1&per_page=100Consultar solo tópicos activos
GET /api/notifications/topics?only_active=trueQuery parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
page | integer | No | 1 | Número de página que querés consultar. |
per_page | integer | No | 100 | Cantidad de tópicos por página. |
only_active | boolean | No | true | Si enviás true, la respuesta incluye solo tópicos activos. |
Qué devuelve este endpoint
La respuesta devuelve un arreglo items. Cada elemento representa un tópico disponible para notificaciones.
| Campo | Tipo | Descripción |
|---|---|---|
topic_id | integer | Código identificador del tópico. |
name | string | Nombre del tópico. |
event_type | string | Tipo de evento asociado al tópico. |
is_active | boolean | Indica si el tópico está activo. |
Respuesta esperada
{
"items": [
{
"topic_id": 1,
"name": "account_statements_update",
"event_type": "forward_response",
"is_active": true
},
{
"topic_id": 2,
"name": "market_order_update",
"event_type": "forward_response",
"is_active": true
}
]
}Cuándo usar este endpoint
Este endpoint es útil cuando necesitás:
- descubrir los tópicos disponibles para suscripción
- validar si un tópico sigue activo
- identificar el
topic_idpara asociarlo a una configuración de webhook
Errores frecuentes
422 Validation Error: alguno de los query parameters tiene un formato inválido.
Siguiente paso
Después de identificar el tópico que necesitás, consultá su detalle con GET /api/notifications/topics/{topic_id} o revisá la configuración de webhooks con GET /api/notifications/client-hooks.
