VA statement

Retrieve transaction details for a virtual account for a specified date and time range. Use this API to review credits, debits, transaction references, amounts, and other available transaction details.

Important information

The user must provide the valid credentials in the header
Encrypted and valid Signature and an active "Access Token"
Request format as specified with all the mandatory details with appropriate request tags
Date range for search: 7 days period

Domain details
Environment
Domain
Rate/Limit
Sandbox
sandboxapi.onesingleview.com
3 Calls per Minute
Production/LIVE
To be provided upon onboarding
Based on contract

Environment	Domain	Rate/Limit
Sandbox	sandboxapi.onesingleview.com	3 Calls per Minute
Production/LIVE	To be provided upon onboarding	Based on contract

Generate virtual account statement

Endpoint details

Endpoint URL	Method	Authentication requirements
`/api/v2/virtualaccount/statement`	POST	`SVReferenceID` `CompanyId` `Device` `DateTimeStamp` `Authorization: Bearer`

Sample request

Virtual Account Statement Request

curl --location 'https://sandboxapi.onesingleview.com/api/v2/virtualaccount/statement' \
--header 'SVReferenceID:  SV123456' \
--header 'CompanyId: SINGLEVIEW1234' \
--header 'Device: web' \
--header 'DateTimeStamp: 2025-01-07T10:20:39' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNeVN4WFRCZjlqUlNWQzFad3B5QnlkOVpHelZXR2ZwUmFQNUUrY3d6cVQ5bi9OV0lwR2V5STNNMkdPL1pqakd4ZG0yclJkVEZxY3lhWGNpWnZFejl0V1EySjQxK2VvSlk2ZjdJZkFsV3BKRi9VL1YydDEzMUtnRnVhcnd6MzVQY1UzbnFEV0p0UWlzIiwiaWF0IjoxNzY3NzYxODc3LCJleHAiOjE3Njc3NjU0Nzd9.lWDSB3Rk_TtdUbKyFcCdaE5XGo7UDiTu2kDcqEyU7vg' \
--header 'Content-Type: application/json' \
--data '{
  "Message": {
  "SVVAStatementReq": {
      "TransactionType": "VASTMT",
      "BankCode": "ALRAJHI",
      "CompanyCode": "125001291",
      "ReferenceNumber": "SVVA53086",
      "SchemeId": "CollectionOSV",
      "VAClientId": "SV123456789",
      "VirtualIBAN": "SA5680900000735991239014"
      "FromDate": "2026-04-27T00:00:00",
      "ToDate": "2026-04-27T08:00:00"
    }
  },
"Signature": "rZZ9alg/2k9B5uWSdnW3AfYswAMqA4HXyNX3jIzckWb4o37uS4eKFEQ3xRn/dBarN6EGjfaXiMSOPdKyyjjrgT80K5ReXzQ7cC1INuU79ozlLgK8yTFz+nq785geQ+He4PR+hD35DkF9qnela9qmcr3GhAXpTjZG12hmaJEyzeofh6q3p+jqLFd208eAImubnL6SbSBDEAi5SLRH1K2I1U77OmFNirrfGV8qd+gsi+lqgyF9mpNj6lzy/fJNNe0qEr2WHvG1R7E2g3EhqovDNanQt6RFgkWegtlE37Eyi5qO3xlTqu76317ZWfMI7jHxs48fOLTNtBCOwUboVze5Tw=="
}'

Request parameters

JSON Tag	Requirement	Description	Data type
Message	Mandatory	Header information (client credentials)	Object
SVVAStatementRequest	Mandatory	Root node containing all the info to generate statement of a virtual account	Object
TransactionType	Mandatory	Details on the type of transaction to be specified as `VASTMT`	String
BankCode	Mandatory	Unique bank identification code `ALRAJHI` - Al Rajhi Bank	String
ReferenceNumber	Mandatory	Unique reference number for the request generated by the client Maximum length : 16 numeric characters	String
SchemeId	Mandatory	Identifier of the virtual account scheme provided by the partner bank to the client	String
VAClientId	Mandatory	Unique client identifier for the virtual account provided by the partner bank to the client	String
VirtualIBAN	Mandatory	IBAN of the virtual account to be provided for balance enquiry service	String
FromDate	Mandatory	Specifies start date and time for filtering of the transaction records	Date
ToDate	Mandatory	Specifies end date and time for filtering of the transaction records	Date
Signature	Mandatory	Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)	String

Sample response

Virtual Account Generate Statement Response

{
  "SVVAStatementResp": {
    "TransactionType": "VASTMT",
    "BankCode": "SABB",
    "ReferenceNumber": "SVVA53086",
    "StatusCode": "Completed",
    "StatusDetail": "Virtual account statement fetched successfully.",
    "OSVVAStatementDetails": {
      "ClientId": "SASABB802044024",
      "SchemeId": "VACOL1",
      "VirtualIBAN": "SA5680900000735991239014",
      "FromDate": "2026-04-27T00:00:00",
      "ToDate": "2026-04-27T08:00:00",
      "RemitterId": "4193",
      "StatementReference": "",
      "StatementId": "",
      "TransactionData": [
          {
            "TransactionId": "20260913BTBQ00002",
            "FinancialReference": "01-27300-001-0006080002863-20220118-9000001",
            "Amount": "33.00",
            "Currency": "SAR",
            "ValueDate": "260427",
            "EntryDate": "",
            "DCMark": "C",
            "Description": "",
            "SourceAccount": "",
            "SourceID": ":",
            "SourceAccountName": ""
          }
        ]
      }
    }
  }

Response parameters

JSON Tag	Description	Data type
SVVAStatementResp	Root node	Object
TransactionType	Details on the type of transaction as specified in the request as `VASTMT`	String
BankCode	Unique bank identification code `ALRAJHI` - Al Rajhi Bank	Object/Array
ReferenceNumber	Unique reference number for the request generated and passed by the client in the request	String
StatusCode	Code representing status of the transaction processing	String
StatusDetail	Details of the status code represented for the transaction processing	String
OSVVAStatementDetails	Tag carrying information on the statement	Object
ClientId	Unique client identifier associated with the statement virtual account	String
SchemeId	Identifier of the virtual account scheme	String
VirtualIBAN	IBAN of the virtual account for the corresponding statement	String
FromDate	Start date and time of the statement period	Date
ToDate	End date and time of the statement period	Date
RemitterId	Identifier of the remitter associated with the virtual account	String
StatementReference	Reference associated with the statement	String
StatementId	Unique identifier of the statement	String
TransactionData	Tag carrying information on transactions related to the mentioned account	Object
TransactionId	Unique identifier of the transaction	String
FinancialReference	Financial reference associated with a credit transaction, when provided by the bank	String
Amount	Transaction amount	String
Currency	Currency of the transaction	String
ValueDate	Date on which the transaction value is applied	String
EntryDate	Date on which the transaction is recorded	String
DCMark	Indicates whether the transaction is a debit or credit as `D` or `C`	String
Description	Transaction description, when available	String
SourceAccount	Source account associated with the transaction, when available	String
SourceID	Identifier of the transaction source	String
SourceAccountName	Name associated with the source account, when available	String

Status Codes & Information

StatusCode	StatusDetail
Completed	Statement fetched successfully.
Failed	Bank response description
Response_Timeout	Timeout! Unable to get response from the bank. Please try again or contact SingleView support if issue persists.1

Categories

GENERAL INFORMATION

GETTING STARTED

AUTHENTICATION

Data APIs

Payment APIs

SADAD

Virtual Accounts

SME Onboarding (Draft)

RESOURCES

API Archives

Domain details

Generate virtual account statement

Endpoint details

Sample request

Sample response

Status Codes & Information