GET
/connected-banking/v1/bank-balanceCheck Bank Balance
Query real-time bank account balances through Connected Banking API.
Last updated: 2026-02-21
Check Bank Balance
Endpoint (Requires Authentication)
GET /api/v1/connected-banking/public/bank-balance/{channel}
Request Headers
Content-Type: application/json
Authorization: Bearer <jwt_token>
Path Parameters
channel = SHIVALIK
Encrypted Success Response (200 OK)
{
"resp_code": 2000,
"resp_message": "Balance retrieved successfully",
"data": "encrypted_base64_string_here"
}
Decrypted Success Response
{
"balance": 10000.50,
"account_number": "XXXX1234",
"currency": "INR",
"channel": "SHIVALIK",
"timestamp": "2024-01-15T10:30:00.000Z"
}
Response Codes
| Code | Message |
|---|---|
| 2000 | Balance retrieved successfully |
| 4041 | Bank channel not supported |
| 4042 | Merchant channel configuration not found |
| 4043 | Bank account details not configured for this merchant |
| 4001 | Unauthorized access |
| 4290 | Rate limit exceeded |
| 5001 | Failed to retrieve balance from bank |
| 5000 | Internal server error |