Webhook endpoints
List deliveries of an endpoint
The delivery log of the endpoint, newest first: status, attempts, last response.
GET
/v1/webhook_endpoints/{id}/deliveriesscope webhooks:readPath parameters
idstringrequiredWebhook endpoint ID (
we_…).
Query parameters
limitintegerdefault 20Page size, 1-100.
cursorstringThe
next_cursorof the previous page. Omit for the first (newest) page. Up to 1024 characters.statusstringOne of:
pending,succeeded,failed
Headers
ZyloPay-VersionstringPin the request to an API version (2026-09-28). Defaults to the version the API key was created with.
Returns
HTTP 200 with a list object: data holds up to limit webhook delivery objects, newest first; has_more and next_cursor drive pagination.
Errors
| Status | Meaning |
|---|---|
400 | Invalid request (invalid_request_error / idempotency_error). |
401 | Missing, invalid, expired or revoked API key (authentication_error). |
403 | The key lacks the scope, the IP is not allowed, or the account is disabled (permission_error). |
429 | Rate limit reached for this key (rate_limit_error); see Retry-After. |
500 | Internal error (api_error). Retry with the same Idempotency-Key. |
Branch on error.code. Every code is listed in error codes.
Example request
curl "https://zylopay-api.fly.dev/api/v1/webhook_endpoints/we_2Lk9Qm4Xz7Pv1Rt8Wb3Ns6Hd/deliveries?status=failed" \
-H "Authorization: Bearer $ZYLOPAY_SECRET_KEY"Example response
{
"object": "list",
"data": [
{
"id": "wdl_8Tq3Zm1Xk6Pv9Rw2Lb4Ns7Hd",
"object": "webhook_delivery",
"livemode": false,
"endpoint": "we_2Lk9Qm4Xz7Pv1Rt8Wb3Ns6Hd",
"event": "evt_7Hq2Zp9LwK4mXr8Vb3Ns1Td5",
"event_type": "payment.succeeded",
"status": "failed",
"attempts": 12,
"manual": false,
"next_attempt_at": null,
"last_attempt_at": "2026-10-01T09:41:12.000Z",
"last_status_code": 500,
"last_error": "HTTP 500",
"created": "2026-09-28T14:02:40.000Z",
"completed_at": "2026-10-01T14:02:40.000Z"
}
],
"has_more": false,
"next_cursor": null
}