Your account
Balances and wallets
Every wallet on the account, its balance and what is available to spend.
GET
/v1/balancesSigned · readconst { wallets } = await tukupay.balances();available is the balance less what is set aside (for example payouts waiting for approval). Use wallet_id wherever an endpoint asks for a wallet.
GET
/v1/walletsSigned · readGET
/v1/wallets/{walletId}Signed · read{
"id": 7,
"name": "Main Wallet",
"alias": "TKW12345",
"provider": "sasapay",
"account_number": "…",
"is_primary": true,
"is_active": true,
"currency": "KES",
"balance": "12500.00",
"available": "12000.00",
"created_at": "2026-10-01T08:00:00.000Z"
}GET /wallets answers a list of these. A wallet that is not on the account is 404 wallet_not_found.
POST
/v1/walletsSigned · walletsOpens another wallet on the account, within the wallet provider's limits: name, purpose, nature_of_business, physical_address. In the sandbox nothing is opened and the answer is { simulated: true, id: null, … }.