TransactionHistory
GET
https://test.api.neotek.sa/b2b-unified/v1/statements/transactionsSandbox URL · in Production call https://api.neotek.sa
Every transaction across a date range, paginated. Served from Neotek's synced store rather than a live bank call, so it returns instantly and spans any range in one request.
The account has to be onboarded first, and data starts from the onboarding date rather than retroactively.
Query parameters:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | which bank holds the account: RJHISARI or ARNBSARI |
accountIban | Required | the account to read |
fromDate | Required | start of the range, as YYYY-MM-DD |
toDate | Optional | end of the range. Defaults to yesterday, and is capped at T-1 |
page | Optional | defaults to 1 |
pageSize | Optional | defaults to 50, minimum 1, maximum 500 |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
cURL
curl -G 'https://test.api.neotek.sa/b2b-unified/v1/statements/transactions' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ -d 'bankCode=ARNBSARI' \ -d 'accountIban=SA1030000012345678901004' \ -d 'fromDate=2026-01-01' \ -d 'toDate=2026-02-14' \ -d 'page=1' \ -d 'pageSize=50'Response (trimmed to one transaction) — the same transaction fields as MT940, plus a pagination object. Results are sorted newest first by post date.
JSON
{ "success": true, "code": "SUCCESS", "message": "Transactions retrieved successfully", "accountIban": "SA1030000012345678901004", "fromDate": "2026-01-01", "toDate": "2026-02-14", "transactions": [ { "transactionId": "TXN001", "postDate": "2026-02-14", "valueDate": "2026-02-14", "postingTime": "14:30:00", "direction": "DEBIT", "amount": "1500.00", "currency": "SAR", "description": "Payment to supplier", "referenceNumber": "REF123456", "counterPartyAccount": "SA1045000012345678901005", "counterPartyName": "Supplier Corp", "runningBalance": "48500.00" } ], "pagination": { "page": 1, "pageSize": 50, "totalElements": 150, "totalPages": 3, "hasNextPage": true }}Errors — all four services share the same failure shape and codes; see Statements → Errors.