GET
Account Balance
Retrieve the current available and ledger balance for a specific account.
GET/v2/account/{account_number}/balance
Use this endpoint to fetch the real-time financial balance of a customer's account. This is particularly useful before initiating a transfer or loan disbursement to ensure sufficient funds.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_number | string | YES | The 10-digit account number you want to retrieve the balance for. |
Example Request
cURL
curl -X GET "https://sandbox.hexcore.io/v2/account/1234567890/balance" \-H "Authorization: Bearer sk_test_your_secret_key"Example Response
JSON (200 OK)
{"status": true,"message": "Balance retrieved successfully","data": {"account_number": "1234567890","currency": "NGN","available_balance": 500000.00,"ledger_balance": 505000.00} }