Skip to main content
The Accounts API allows you to manage your payment accounts (wallets) and view their balances.

​
Overview

When you create a Bila merchant account, you automatically get a primary wallet. You can use this wallet to:
  • Receive payments from customers (collections)
  • Send payouts to recipients (transfers)
  • View your balance and transaction history

​
Endpoints

EndpointMethodDescription
/bila/accountsGETList all accounts/wallets
/bila/accounts/{id}GETGet a single account by ID
/bila/accounts/{id}/balanceGETGet account balance

​
Account Object

{
  "id": "68f11209-451f-4a15-bfcd-d916eb8b09f4",
  "details": {
    "type": "wallet",
    "accountName": "My Business Wallet",
    "tillNumber": "123456"
  },
  "type": "primary",
  "status": "active",
  "createdAt": "2024-01-15T10:30:00Z",
  "currency": "ZMW"
}

​
Balance Object

{
  "availableBalance": 15000.00,
  "ledgerBalance": 15500.00,
  "currency": "ZMW"
}
Available Balance is the amount you can withdraw or transfer. Ledger Balance includes pending transactions.

​
Use Cases

Before initiating a transfer, check your available balance to ensure sufficient funds.
If you have multiple wallets, list them all and track balances across your organization.

API Reference

View the interactive API reference for Accounts endpoints