Listar webhooks enviados

Retorna el historial de webhooks enviados. Filtra por estado o evento para encontrar envíos fallidos y reenviarlos.

GEThttps://api.facturalo.pe/api/v3/webhooks

Parámetros del request

Authorization
header · stringrequerido
Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...
estado
query · stringopcional
Filtra por estado: "FALLIDO" · "OK".Ej: FALLIDO
evento
query · stringopcional
Filtra por tipo de evento.Ej: documento.sunat.respuesta
per_page
query · intopcional
Registros por página. Default: 20.Ej: 20
page
query · intopcional
Página a consultar. Default: 1.Ej: 1

Parámetros del response

data
objectrequerido
Contenedor principal del resultado.
total
numberrequerido
Total de registros encontrados.
per_page
numberrequerido
Registros por página.
current_page
numberrequerido
Página actual.
items
arrayrequerido
Lista de webhooks enviados.
id
stringrequerido
ID único del evento webhook.
tipo
stringrequerido
Tipo interno del evento (ej: "documento.webhook.fallido").
estado
stringrequerido
"ok" si el servidor respondió 2xx, "error" en caso contrario.
evento
stringrequerido
Nombre del evento enviado (ej: documento.sunat.respuesta).
url
stringrequerido
URL a la que se envió el webhook.
httpStatus
string | nullopcional
Código HTTP recibido del servidor destino.
error
string | nullopcional
Mensaje de error si el envío falló.
duracionMs
numberrequerido
Duración del envío en milisegundos.
documento
objectrequerido
Referencia al documento asociado al evento.
id
stringrequerido
ID del documento.
serie
stringrequerido
Serie del documento.
correlativo
stringrequerido
Correlativo del documento.
fecha
stringrequerido
Fecha y hora del envío en ISO 8601 con zona horaria.
Requestjson
// Sin body — GET request
// Authorization: sk_test_...
// Query: ?estado=FALLIDO&evento=documento.sunat.respuesta&per_page=20&page=1
200 — Webhooks obtenidosjson
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 42,
        "tipo": "WEBHOOK_ENVIADO",
        "estado": "OK",
        "evento": "documento.sunat.respuesta",
        "url": "https://tuapp.com/webhooks/facturalo",
        "httpStatus": 200,
        "error": null,
        "duracionMs": 85,
        "documento": {
          "id": "eb5e89d0-67d9-11f1-8bd0-5b2bb30404ab",
          "serie": "F001",
          "correlativo": "00000123"
        },
        "fecha": "2026-06-14T09:52:56-05:00"
      }
    ],
    "total": 1,
    "per_page": 20,
    "current_page": 1
  }
}