Skip to main content
Use this endpoint to fetch the real-time balance of any account that belongs to your business. The balance reflects settled transactions at the time of the request. You can use this endpoint to poll balances for reconciliation workflows or to display live balances in your application. Endpoint 
POST https://baasapi.payrepmfb.com/api/v1/account/api/get_account_balance
Sandbox 
POST https://shogun-dev.xchangeboxng.com/api/v1/account/api/get_account_balance

​
Authentication

Include your Bearer token in the Authorization header: 
Authorization: Bearer <access_token>
Obtain a token from Generate Token.

​
Request body

​
account_number
string
required
The 10-digit account number to query. The account must belong to your business. Maximum 10 characters.

​
Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/account/api/get_account_balance \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_number": "7801234567"
  }'

​
Response

​
Success

​
status
boolean
true when the request succeeds.
​
response_code
string
"00" on success.
​
message
string
Human-readable result message.
​
data
object
The account details including the current balance.
{
  "status": true,
  "response_code": "00",
  "message": "Success",
  "data": {
    "account_number": "7801234567",
    "account_name": "Lagos Branch Sales",
    "account_type": "current",
    "status": "active",
    "balance": "250000.000000000",
    "last_balance_update": "2026-02-25T12:00:00Z"
  }
}

​
Error codes

CodeMeaning
00Success
41Customer not found — your API credentials are invalid
80Service unavailable — the core banking provider is temporarily down
83Provider error — the balance query was rejected by the core banking system