Bank payouts
List payouts
GET
/payoutsScope
payouts:readAuth Bearer keyQuery parameters
cursorstringoptionallimitintegeroptionalResponses
200Payout list
json
{
"object": "list",
"data": [
{
"id": "WD-7C41A9E2",
"object": "payout",
"status": "processing",
"reference": "WD-7C41A9E2",
"rail": "bank",
"currency": "NGN",
"amount": "185000.00",
"fee": "50.00",
"destination": {
"account_number": "0123456789",
"account_name": "Bright Ideas Ltd",
"bank_code": "058",
"bank_name": "GTBank"
},
"narration": "Supplier settlement",
"failure_reason": null,
"livemode": true,
"created_at": "2026-08-30T10:02:11.417Z",
"updated_at": "2026-08-30T10:02:13.902Z"
},
{
"id": "WD-3B90D5F1",
"object": "payout",
"status": "processing",
"reference": "WD-3B90D5F1",
"rail": "crypto",
"currency": "USDT",
"amount": "1250.50",
"fee": "1.00",
"destination": {
"address": "0x8Ae2C1b7F0d94E31aA5c60b17E9C4d3f0821b7A5",
"network": "BASE"
},
"narration": "Treasury sweep",
"failure_reason": null,
"livemode": true,
"created_at": "2026-08-30T10:20:44.118Z",
"updated_at": "2026-08-30T10:20:47.501Z"
}
],
"next_cursor": null,
"has_more": false
}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/payouts" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY"
