List webhook deliveries
List delivery attempts for a webhook endpoint with cursor-based pagination. Each delivery captures the HTTP response status, body (truncated), duration, and retry schedule.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/companies/{company}/webhook-endpoints/{webhook_endpoint}/deliveries
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).
Public identifier (UUID v7) of the webhook endpoint.
Query parameters
Number of objects to return, between 1 and 100 (default 25).
Cursor for forward pagination: pass the id of the last object on the previous page (the next_cursor of the previous response).
Cursor for backward pagination: pass the id of the first object on the current page.
Delivery status (pending, succeeded, failed). Exact match on status.
Comma-separated list of values (CSV).
Delivery status (pending, succeeded, failed). Comma-separated list. Any of the values matches.
Type of the delivered event. Exact match on event.
Comma-separated list of values (CSV).
Type of the delivered event. Comma-separated list. Any of the values matches.
Delivery creation date (ISO 8601). Greater than or equal to the given value.
Delivery creation date (ISO 8601). Less than or equal to the given value.
Delivery creation date (ISO 8601). Strictly greater than the given value.
Delivery creation date (ISO 8601). Strictly less than the given value.
Headers
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Response
Example response
{
"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": {
"data": {
"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",
"price_list_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b10",
"price_list_name": "Tarifa profesional 2026",
"issued_on": "2026-03-15",
"due_on": "2026-04-14",
"operation_on": null,
"subtotal": "1000.00",
"taxes_total": "210.00",
"total_vat": "210.00",
"total_retention": "0.00",
"total_surcharge": "0.00",
"total": "1210.00",
"total_disbursements": "0.00",
"total_to_pay": "1210.00",
"currency": "EUR",
"notes": "Servicios profesionales marzo 2026.",
"external_id": "ERP-2026-0042",
"lines": [
{
"object": "invoice_line",
"description": "Consultoría técnica (10 h)",
"additional_description": "Auditoría inicial e informe de mejoras",
"product": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b03",
"name": "Consultoría técnica (hora)"
},
"quantity": 10,
"unit_price": "100.0000",
"tax_rate": 21,
"retention_rate": 0,
"surcharge_rate": 0,
"discount_percent": 0,
"subtotal": "1000.00",
"taxes": "210.00",
"total": "1210.00",
"variant": null,
"presentation": null,
"item_kind": "service",
"commercial_unit_code": "HUR",
"base_unit_code": "HUR",
"conversion_factor": "1.000000",
"base_quantity": "10.0000",
"counted_quantity": null,
"counted_unit": null,
"price_list_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b10",
"price_list_name": "Tarifa profesional 2026",
"price_source": "price_list",
"price_unit_code": "HUR",
"configuration": null,
"options": [],
"price_semantics": "per_commercial_unit",
"price_adjustment_total": "0.0000",
"option_adjustments_absorbed": false,
"indirect_tax_regime": "iva",
"aeat_tax_code": "S1",
"line_type": "NORMAL"
}
],
"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",
"exemption_reason": null,
"legal_mentions": [],
"exclude_347": false,
"verifactu_status": "accepted",
"paid_amount": "1210.00",
"pending_amount": "0.00",
"payments": {
"detail": [
{
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a90",
"object": "payment",
"invoice_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a42",
"amount": "1210.00",
"payment_date": "2026-03-20",
"payment_method": "bank_transfer",
"payment_method_text": "Transferencia bancaria",
"reference": "TRF-2026-0042",
"notes": null,
"is_reversed": false,
"reversed_at": null,
"reversal_reason": null,
"reversal_reason_text": null,
"reversal_note": null,
"created_at": "2026-03-20T10:30:00Z",
"updated_at": "2026-03-20T10:30:00Z"
}
],
"total": "1210.00",
"pending": "0.00"
},
"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_recorded_at": "2026-03-20T10:30:00Z",
"paid_date": "2026-03-20",
"issued_at": "2026-03-15T11:45:00Z",
"sent_at": "2026-03-15T11:47:12Z",
"sent_via": "email",
"is_sent": true,
"voided_at": null,
"void_reason": null,
"scheduled_for": null,
"scheduled_action": null,
"channel": null,
"source_store_id": null,
"origin": "native",
"created_at": "2026-03-15T11:30:00Z",
"updated_at": "2026-03-20T10:30:00Z"
}
}
}
}
],
"has_more": true,
"next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c"
}Changes
No recorded changes to this operation across all 1 revision of this API.