MT940
GET
https://test.api.neotek.sa/b2b-unified/v1/statements/mt940Sandbox URL · in Production call https://api.neotek.sa
The finalized end-of-day statement for one past date, with its opening and closing balances. A live call to the bank, so expect 2 to 5 seconds and one date per request.
Query parameters:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | which bank holds the account: RJHISARI or ARNBSARI |
accountIban | Required | the account to read |
statementDate | Required | the day to fetch, as YYYY-MM-DD |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
cURL
curl -G 'https://test.api.neotek.sa/b2b-unified/v1/statements/mt940' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ -d 'bankCode=ARNBSARI' \ -d 'accountIban=SA1030000012345678901004' \ -d 'statementDate=2026-01-01'Response (trimmed to one transaction)
JSON
{ "success": true, "code": "SUCCESS", "message": "Statement retrieved successfully", "accountIban": "SA1030000012345678901004", "statementDate": "2026-01-01", "openingBalance": { "amount": "100000.00", "currency": "SAR" }, "closingBalance": { "amount": "85500.00", "currency": "SAR" }, "transactions": [ { "transactionId": "TXN001", "postDate": "2026-01-01", "valueDate": "2026-01-01", "postingTime": "10:30:00", "direction": "DEBIT", "amount": "14500.00", "currency": "SAR", "description": "Salary payment", "referenceNumber": "REF12345", "counterPartyAccount": "SA1045000012345678901005", "counterPartyName": "Ahmed Hassan", "runningBalance": "85500.00" } ]}Errors — all four services share the same failure shape and codes; see Statements → Errors.