VAStatement
GET
https://test.api.neotek.sa/b2b-unified/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 |
toDate | Optional | end of the range, defaulting to today |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
x-app-id | Required | your application id |
cURL
curl -G 'https://test.api.neotek.sa/b2b-unified/va/v1/remitters/{remitterId}/statement' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'x-app-id: <APP_ID>' \ -d 'bankCode=RJHISARI' \ -d 'remitterIban=SA4580000204000010006087' \ -d 'fromDate=2026-05-01' \ -d 'toDate=2026-05-13'Response (trimmed to one transaction)
JSON
{ "success": true, "code": "SUCCESS", "message": "Statement retrieved successfully", "remitterId": "CUST001", "remitterIban": "SA4580000204000010006087", "schemeId": "SCHEME001", "fromDate": "2026-05-01", "toDate": "2026-05-13", "balances": { "openingBalance": "10000.00", "closingBalance": "45000.00", "availableBalance": "45000.00", "clearingBalance": "45000.00", "blockedBalance": "0.00" }, "summary": { "totalTransactions": 3, "netAmount": "35000.00", "netDirection": "CREDIT" }, "transactions": [ { "transactionId": "TXN20260505001", "amount": "25000.00", "currency": "SAR", "direction": "CREDIT", "status": "BOOKED", "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": { "bankName": "Saudi National Bank", "bic": "NCBKSAJE" } } ], "msgReference": "STM001"}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 | BOOKED, PENDING, REJECTED or 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. Present on CREDIT transactions |
debtorAgent | Who received it. Present on DEBIT transactions |
merchantName | For POS and merchant transactions. Nullable |
BOOKED transactions are final and immutable. PENDING ones are still in flight and may change.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.