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

Explore the complete API reference