Lista las entregas de webhook

Lista los intentos de entrega de un webhook endpoint con paginación por cursor. Cada entrega captura el estado de la respuesta HTTP, el cuerpo (truncado), la duración y la programación de reintentos.

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

webhook_endpoint*string

Parámetros de consulta

limit?integer

Número de objetos a devolver. Entero entre 1 y 100. Por defecto 25.

Predeterminado25

Rango1 <= value <= 100

starting_after?string

Cursor para paginación hacia delante. Usa el uuid del último objeto de la página anterior.

Formatouuid

ending_before?string

Cursor para paginación hacia atrás. Usa el uuid del primer objeto de la página actual.

Formatouuid

status?string

Estado de entrega (pending, succeeded, failed). Coincidencia exacta en status.

status[in]?string

Estado de entrega (pending, succeeded, failed). Lista separada por comas. Coincide cualquiera de los valores.

event?string

Tipo del evento entregado. Coincidencia exacta en event.

event[in]?string

Tipo del evento entregado. Lista separada por comas. Coincide cualquiera de los valores.

created[gte]?string

Fecha de creación de la entrega (ISO 8601). Mayor o igual que el valor dado.

Formatodate-time

created[lte]?string

Fecha de creación de la entrega (ISO 8601). Menor o igual que el valor dado.

Formatodate-time

created[gt]?string

Fecha de creación de la entrega (ISO 8601). Estrictamente mayor que el valor dado.

Formatodate-time

created[lt]?string

Fecha de creación de la entrega (ISO 8601). Estrictamente menor que el valor dado.

Formatodate-time

Cuerpo de la respuesta

`application/json`

{
  "has_more": true,
  "next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c",
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c",
      "object": "webhook_delivery",
      "webhook_endpoint_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0b",
      "event_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0d",
      "event_name": "invoice.paid",
      "status": "delivered",
      "attempt": 1,
      "next_retry_at": "2026-01-25T18:05:00Z",
      "response_status": 200,
      "response_body_truncated": "{\"received\":true}",
      "duration_ms": 142,
      "signature": "t=1737830400,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd",
      "request_headers": {
        "Content-Type": "application/json",
        "Factuarea-Event-Id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0d"
      },
      "completed_at": "2026-01-25T18:00:01Z",
      "created_at": "2026-01-25T18:00:00Z",
      "payload": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "type": "invoice.created",
        "api_version": "string",
        "created": 0,
        "livemode": true,
        "correlation_id": "807686c4-116c-44b3-a01c-b14b50e31bcc",
        "data": {
          "type": "invoice.created",
          "object": {
            "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a42",
            "object": "invoice",
            "number": "FAC-2026-00042",
            "is_number_assigned": true,
            "type": "F1",
            "series": {
              "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b02",
              "code": "FAC-2026"
            },
            "client": {
              "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
              "name": "Acme Soluciones SL"
            },
            "status": "paid",
            "issued_on": "2026-03-15",
            "due_on": "2026-04-14",
            "subtotal": 1000,
            "taxes_total": 210,
            "total": 1210,
            "currency": "EUR",
            "notes": "Servicios profesionales marzo 2026.",
            "external_id": "ERP-2026-0042",
            "lines": [
              {
                "object": "invoice_line",
                "description": "Consultoría técnica (10 h)",
                "product": {
                  "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b03",
                  "name": "Consultoría técnica (hora)"
                },
                "quantity": 10,
                "unit_price": 100,
                "tax_rate": 21,
                "discount_percent": 0,
                "subtotal": 1000,
                "taxes": 210,
                "total": 1210
              }
            ],
            "metadata": {
              "order_id": "PO-2026-0042"
            },
            "tags": [
              "consultoria",
              "cliente-vip"
            ],
            "custom_fields": [
              {
                "field": "centro_coste",
                "value": "CC-2026-001"
              },
              {
                "field": "numero_pedido",
                "value": "PO-2026-0042"
              }
            ],
            "operation_regime": "general",
            "exclude_347": false,
            "verifactu_status": "accepted",
            "paid_amount": 1210,
            "pending_amount": 0,
            "payments": {
              "detail": [
                {
                  "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a90",
                  "object": "payment",
                  "invoice_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a42",
                  "amount": 1210,
                  "payment_date": "2026-03-20",
                  "payment_method": "bank_transfer",
                  "payment_method_text": "Transferencia bancaria",
                  "reference": "TRF-2026-0042",
                  "notes": null,
                  "created_at": "2026-03-20T10:30:00Z",
                  "updated_at": "2026-03-20T10:30:00Z"
                }
              ],
              "total": 1210,
              "pending": 0
            },
            "is_corrective": false,
            "corrective": null,
            "payment": {
              "method": "bank_transfer",
              "reference": "TRF-2026-0042",
              "date": "2026-03-20"
            },
            "public_link": {
              "object": "public_link",
              "url": "https://app.factuarea.com/d/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a42",
              "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a42",
              "enabled": true,
              "expires_at": "2026-09-15T23:59:59Z",
              "max_days": 120
            },
            "substituted_by": null,
            "recurring": null,
            "paid_at": "2026-03-20T10:30:00Z",
            "paid_on": "2026-03-20",
            "sent_at": "2026-03-15T11:45:00Z",
            "voided_at": null,
            "void_reason": null,
            "created_at": "2026-03-15T11:30:00Z",
            "updated_at": "2026-03-20T10:30:00Z"
          }
        }
      }
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "El campo `name` es obligatorio y no puede estar vacío.",
    "param": "name",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
    "request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Lista las entregas de webhook

Authorization

Parámetros de ruta

Parámetros de consulta

Cuerpo de la respuesta

200application/json

401application/json

403application/json

422application/json

429application/json

500application/json

Falta la API key

Formato de API key no válido

API key revocada

La API key carece del scope requerido

Se requiere mejorar el plan

El add-on requerido no está activo

El parámetro no superó la validación

Límite del plan alcanzado (autorización)

Formato de Idempotency-Key no válido

Modelo 303 sin trimestre

Modelo 347 con trimestre

Año fuera de rango

No hay facturas en el periodo

Formato no válido

No hay formateador disponible para la combinación de tipo/formato/año

Imagen de firma demasiado grande (>2MB)

Transición de estado de documento no válida

Factura ya pagada

Presupuesto ya aceptado

Límite de peticiones superado

Demasiados fallos de autenticación (bloqueo temporal)

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`