VAStatusInquiry
GET
https://test.api.neotek.sa/b2b-unified/va/v1/remitters/{remitterId}/statusSandbox URL · in Production call https://api.neotek.sa
The VA's current status, cap and per-channel configuration.
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 |
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}/status' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'x-app-id: <APP_ID>' \ -d 'bankCode=RJHISARI' \ -d 'remitterIban=SA4580000204000010006087'Response — blocked is the account-level master switch; true means nothing flows regardless of channel settings
JSON
{ "success": true, "code": "SUCCESS", "message": "Status inquiry successful", "remitterId": "CUST001", "remitterIban": "SA4580000204000010006087", "schemeId": "SCHEME001", "accountStatus": "VERIFIED", "blocked": false, "capAmount": "50000.00", "startDate": "2026-05-13", "endDate": "2027-05-13", "incomingChannels": { "cash": true, "accountTransfer": true, "cheque": true, "sarie": true, "overseas": true, "eChannels": true, "cdm": true, "ips": true }, "outgoingChannels": { "accountTransfer": true, "sarie": true, "overseas": true }, "msgReference": "STQ001"}accountStatus is the VA's status at ARB, for example VERIFIED or BLOCKED. capAmount is the maximum configured on this VA.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.