Ledger
Wallet & Funding API
Programmatically check balances, generate dedicated Virtual NGN Accounts, initialize card funding, execute peer transfers, and stream ledger statement history.
GET
/api/v1/wallet/transactionsList Transactions & Ledger
Retrieve paginated transaction records with real-time token/PIN resolution and transaction origination channel tracking ('api' vs 'dashboard').
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Query Parameters
Parameter
Type
Description
page
integer
Page number (default: 1)
page_size
integer
Items per page (max: 100)
type
string
'credit' or 'debit'
category
string
'bill_payment', 'sms', 'funding', 'refund', 'transfer'
search
string
Search by reference or description
Code Execution Playground
Request Snippet (CURL)
curl -X GET "https://backend.cbivas.com/api/v1/wallet/transactions?page=1&page_size=10" \ -H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Success Response (200 OK)
{
"items": [
{
"id": "8c7f89b1-dedf-4f42-8430-858908067074",
"type": "debit",
"category": "bill_payment",
"channel": "api",
"amount": "49.99",
"balance_before": "93350.00",
"balance_after": "93300.01",
"description": "Data Services - Airtel Data for 08011111111",
"reference": "BP-A700203C418F4577",
"status": "completed",
"token": "",
"customer_id": "08011111111",
"biller": "Airtel Data",
"created_at": "2026-08-25T19:57:55.384210Z"
}
],
"total": 11,
"page": 1,
"page_size": 20,
"total_credits": "900.00",
"total_debits": "7599.99"
}