Query Webhook Deliveries

List webhook delivery attempts for a business.

GET /api/v1/widgets/webhook-deliveries

Returns a list of webhook delivery attempts with their status. Failed deliveries are automatically retried up to 3 times at 30-second intervals.

Parameters

Query

Name	Type	Required	Description
limit	integer	No	Number of items (default 100)
offset	integer	No	Pagination offset
since	integer	No	Unix timestamp (ms) — return items created after this time
until	integer	No	Unix timestamp (ms) — return items created before this time

Request example

curl --request GET 'https://payments.bleepay.com/api/v1/widgets/webhook-deliveries?limit=20' \
  --header 'Authorization: Bearer <business_token>'

Response

Delivery object:

Field	Type	Description
id	string	Delivery identifier
eventType	string	Event type (e.g. deposit.confirmed)
status	string	Delivery status: PENDING, DELIVERED, FAILED, RETRYING
attempts	integer	Number of delivery attempts made
lastAttemptAt	string or null	ISO 8601 timestamp of last attempt
createdAt	string	ISO 8601 creation timestamp

Example response

[
  {
    "id": "dly_abc123",
    "eventType": "deposit.confirmed",
    "status": "DELIVERED",
    "attempts": 1,
    "lastAttemptAt": "2026-06-09T12:05:00.000Z",
    "createdAt": "2026-06-09T12:05:00.000Z"
  }
]