BalanceInquiry
GET
https://test.api.neotek.sa/b2b-unified/v1/statements/balanceSandbox URL · in Production call https://api.neotek.sa
The account's balance right now, as a live call to the bank.
Query parameters:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | which bank holds the account: RJHISARI or ARNBSARI |
accountIban | Required | the account to read |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
cURL
curl -G 'https://test.api.neotek.sa/b2b-unified/v1/statements/balance' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ -d 'bankCode=RJHISARI' \ -d 'accountIban=SA1080000012345678901003'Response
JSON
{ "success": true, "code": "SUCCESS", "message": "Balance retrieved successfully", "accountIban": "SA1080000012345678901003", "balance": "125000.50", "currency": "SAR", "accountStatus": "ACTIVE"}Errors — all four services share the same failure shape and codes; see Statements → Errors.