VAStatement
GET
https://test.api.neotek.sa/b2b-unified/v1/va/v1/remitters/{remitterId}/statementSandbox URL · in Production call https://api.neotek.sa
Transaction history for one VA over a date range, with opening and closing balances and a summary.
Path parameters:
| Parameter | Required | Description |
|---|---|---|
remitterId | Required | the VA identifier |
Query parameters:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
remitterIban | Required | the VA IBAN, SA plus 22 digits |
fromDate | Required | start of the range, as YYYY-MM-DD, never in the future |
toDate | Optional | end of the range, defaulting to today. The range spans 7 days at most |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
cURL
curl -G 'https://test.api.neotek.sa/b2b-unified/v1/va/v1/remitters/{remitterId}/statement' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ -d 'bankCode=RJHISARI' \ -d 'remitterIban=SA1280900000042000003310' \ -d 'fromDate=2026-05-05' \ -d 'toDate=2026-05-11'Response (trimmed to one transaction)
JSON
{ "success": true, "code": "SUCCESS", "message": "Statement retrieved successfully", "remitterId": "1000000042", "remitterIban": "SA1280900000042000003310", "schemeId": "SCHEME001", "fromDate": "2026-05-05", "toDate": "2026-05-11", "balances": { "openingBalance": "10000.00", "closingBalance": "45000.00", "availableBalance": null, "clearingBalance": null, "blockedBalance": "0.00" }, "summary": { "totalTransactions": 3, "netAmount": "35000.00", "netDirection": "CREDIT" }, "transactions": [ { "transactionId": "TXN20260505001", "amount": "25000.00", "currency": "SAR", "direction": "CREDIT", "status": "COLLECTED", "bookingDateTime": "2026-05-05T10:30:00", "valueDateTime": "2026-05-05T10:30:00", "description": "SARIE incoming transfer", "transactionReference": "SARIE-UTI-12345", "bankCode": "ReceivedDebitTransfer", "runningBalance": "35000.00", "creditorAgent": { "name": "Riyadh Retail Co", "bankBic": "NCBKSAJE", "accountId": "SA0310000098765432102210" } } ], "msgReference": "STM001"}balances always has these five keys: for a range that includes today, closingBalance is null; for a range entirely in the past, availableBalance and clearingBalance are null.
Transaction fields
| Field | Description |
|---|---|
transactionId | Bank-assigned transaction id |
amount, currency | The amount and its ISO 4217 code |
direction | CREDIT for money in, DEBIT for money out |
status | Al Rajhi's own status, in capitals, such as COLLECTED |
bookingDateTime | When the transaction was booked |
valueDateTime | Value date of the transaction |
description | Free text. Nullable |
transactionReference | External payment reference — SARIE UTI, SWIFT reference. Nullable |
financialReference | Creditor details for debit entries. Nullable |
bankCode | ARB transaction code, such as ReceivedDebitTransfer or DomesticDebitTransfer |
bankSubCode | ARB sub-code for finer classification. Nullable |
runningBalance | Balance after this transaction. Nullable |
creditorAgent | Who sent the money: name, bankBic and accountId. Present on CREDIT transactions |
debtorAgent | Who received it: name, bankBic and accountId. Present on DEBIT transactions |
merchantName | For POS and merchant transactions. Nullable |
status is Al Rajhi's own value. To find money in, read direction: CREDIT.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.