Webhooks
List webhook events
GET
/webhook-eventsScope
webhooks:readAuth Bearer keyQuery parameters
cursorstringoptionallimitintegeroptionaltypestringoptionalResponses
200Event list
json
{
"object": "list",
"data": [
{
"id": "evt_b71f4d9c2a80",
"object": "webhook_event",
"type": "transfer.completed",
"api_version": "2026-08-29",
"environment": "live",
"business_id": "biz_4410ad",
"resource_id": "trf_9f2c41ab77e04d1e8b6a",
"data": {
"id": "trf_9f2c41ab77e04d1e8b6a",
"object": "transfer",
"status": "completed",
"reference": "RM-9F2C41AB",
"beneficiary_id": "ben_31d0c8a5f4e2",
"source_currency": "NGN",
"destination_currency": "GHS",
"destination_country": "GH",
"amount": "250000.00",
"fee": "1250.00",
"rate": "0.0116",
"destination_amount": "2885.00",
"recipient_name": "Ama Owusu",
"account_number": "0241234567",
"bank_name": "MTN Mobile Money",
"narration": "October retainer",
"failure_reason": null,
"metadata": {
"invoice_id": "inv_2201"
},
"created_at": "2026-08-30T09:14:22.104Z",
"updated_at": "2026-08-30T09:14:25.882Z"
},
"delivery_state": "delivered",
"attempts": 1,
"created_at": "2026-08-30T09:15:01.902Z"
}
],
"next_cursor": "2026-08-30T09:15:01.902Z",
"has_more": true
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X GET "https://business.boundlesspay.com/api/public/v1/webhook-events" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY"
