Open BankingB2B Payouts & InfoERP Integration
Guides
SingleView Console

Account Statement

Retrieve single or multiple bank account balances

SingleView B2B API services Account statement allows users access to request and retrieve specific user bank account statements. Corporate Customers can use this B2B service to get unaltered and raw account statement information, including all the majorly required information.

📘

Mandatory 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

🌐Domain details

EnvironmentDomainRate/Limit
Sandboxsandboxapi.onesingleview.com10 Calls per Minute
Production/LIVETo be provided upon onboardingBased on contract

Get Account Statement

Endpoint details

Endpoint URLMethodGrant type
/api/v1/account/statement/940POST1. CompanyId
2. SVReferenceID
3. DateTimeStamp
4. Device
5. Authorization: Bearer (Token)

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/v1/account/statement/940' \
--header 'CompanyId: MYCOMPANY'
--header 'SVReferenceID: SV150619940615'
--header 'DateTimeStamp	:2025-01-02T10:20:39'
--header 'Device: Web'
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNMlZ4WGpFZmR6WFNWaTFad3B5QnlkOVpHelZXR2ZwUmFQNUV1TXl6S1Aybi94Y0lwR2V5STNNMkdPL1pqakd4ZG0yclJKUkdhRXlaWGNpWnZnOHArMWIyOGtOQTVkZ0VKajVVSEdiTmtNPSIsImlhdCI6MTczNTgwMTQ3NywiZXhwIjoxNzM1ODA1MDc3fQ.Bh7LFkvxNFrLe9dmH5rURWjGpES-u4z2EGeyrNM7z6E'
--header 'Content-Type: application/json' \
--data '{
"Message": {
  "OSVAccountStatementRequest": {
    "FromDate": "2025-01-15T00:00:00",
    "ToDate": "2025-01-15T23:59:59",
    "DateTimeStamp": "2025-01-17T09:13:26",
    "TransactionType": "940",
    "OSVPaymentInfoMessage": [
      {
        "OSVPaymentInfoRequest": {
          "BankCode": "ALRAJHI",
          "CompanyCode": "125001291",
          "AccountNumbers": {
            "AccountNumber": [
              {
                "AccNumber": "204000010006085129123"
              }
            ]
          }
        }
      }
    ]
  }
},
"Signature": "UMEH9M8tXknuRnnkrzRjDHaxFRLyZJ+wDNAl408+nTWyfTKaVcBkLLPhX5DKjTX18HK/oEJ8rmSeoswQuKzk9F2WIcXwZI9C+h7GA5d6r0FEu9hAYG+tDjFSyPDPHunMbILe1rgIlenbHra24Xt2IxAqj5115FEhJyabV0saIveNfK4sPOWtB+HeEAhwP6pwHETZoO4Z9kiMgdIbBbyD43IpRyxVQzogtlNKrkRaW/k16eIGzeS8Nh5g0txEoa3aocQTiVqzEtkwBXMKKUnoMZMCIOsPh7XNDN9nmsad0CNHr5wwJZoc9gC2e/d7fWuUu8xqe8AaSWXm3xTIfostIg=="
}'

Request description:

JSON TagDescriptionData type
Message
Mandatory		 Header information (client credentials)Object & String
OSVAccountStatementRequest
Mandatory		Tag carrying information on request to fetch account statementObject
FromDate
Mandatory		Starting date of the statement period
ISO 8601 format - YYYY-MM-DDTHH:MM:SS		Date
ToDate
Mandatory		Ending date of the statement period
ISO 8601 format - YYYY-MM-DDTHH:MM:SS		String
DateTimeStamp
Mandatory		Stamp denoting the time and date of the request
ISO 8601 format - YYYY-MM-DDTHH:MM:SS		Date
TransactionType
Mandatory		To be mentioned as
942 - For statement about today's transactions
940 - For statement about date ranged transaction statement		Numerical
OSVPaymentInfoMessage
Mandatory		This tag contains multiple banks requestsObject
OSVPaymentInfoRequest
Mandatory		Element rootObject
BankCode
Mandatory		Unique bank identification code (SingleView Identifier)
Ex: ALRAJHI, SABB, BSF, ANB, SNB, ALINMA, GIB, RIYADH, ALBI, BJAZ		Alphabetical
CompanyCode
Mandatory		Sender company code/Identifier provided by the bank during on-boardingString
AccountNumbers
Mandatory		Tag carrying information on bank account numberObject
AccountNumber
Mandatory		Tag carrying an array of strings of bank account numbersArray of string
AccNumber
Mandatory		Unique account number for which the account statement is requested
Input size:
Min - 11 Characters
Max - 24 Characters		Alphanumeric
Signature
Mandatory		Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)String

Sample responses

{
  "OSVAccoutStatementResponse": {
    "FromDate": "2025-01-15T00:00:00",
    "ToDate": "2025-01-15T23:59:59",
    "TransactionType": "940",
    "OSVPaymentInfoMessageResponse": [
      {
        "BankCode": "ALRAJHI",
        "CompanyCode": "125001291",
        "StatusCode": "OK",
        "StatusDetail": "OK",
        "ResponseItemCount": "1",
        "TotalOpeningBalance": "500.09",
        "TotalClosingBalance": "500.09",
        "OSVPaymentInfoResponse": [
          {
            "StatusCode": "OK",
            "StatusDetail": "Statment Initiated Successfully",
            "TransactionType": "940",
            "SequenceNum": "145541",
            "AccountNumber": "204000010006085129123",
            "ReceiptTime": "2025-01-15T00:00:00",
            "ProcessStatus": "1",
            "TransactionData": {
              "UniqueReference": "20250116080008",
              "RelatedReferenceNumber": "SV15061994",
              "AccountNumber": "204608015129123",
              "StatementNo": "00015/001",
              "TransactionTime": "2025-01-15T00:00:00",
              "CurrencyAmountCode": "SAR",
              "OpeningBalance": {
                "DCMark": "C",
                "Date": "250115",
                "Currency": "SAR",
                "Amount": 2000911706.34
              },
              "TransactionDetails": [],
              "ClosingBalance": {
                "DCMark": "C",
                "Date": "250115",
                "Currency": "SAR",
                "Amount": 2000911706.34
              },
              "ClosingAvailableBalance": {
                "DCMark": "C",
                "Date": "250115",
                "Currency": "SAR",
                "Amount": 2000911706.34
              },
              "Comment": "",
              "TotalNumberOfDebits": "01",
              "TotalNumberOfCredits": "00"
            }
          }
        ]
      }
    ]
  }
}

{
  "OSVAccoutStatementResponse": {
    "FromDate": "2025-01-15T00:00:00",
    "ToDate": "2025-01-15T23:59:59",
    "TransactionType": "940",
    "OSVPaymentInfoMessageResponse": [
      {
        "BankCode": "NCB",
        "CompanyCode": "ABC1234",
        "B2BUrn": "",
        "B2BAggrId": "",
        "B2BUserId": "",
        "StatusCode": "Failed",
        "StatusDetail": "Failed",
        "ResponseItemCount": "1",
        "TotalOpeningBalance": "",
        "TotalClosingBalance": "",
        "OSVPaymentInfoResponse": [
          {
            "StatusCode": "OK",
            "StatusDetail": "Statment Initiated Successfully",
            "TransactionType": "940",
            "SequenceNum": "145541",
            "AccountNumber": "204000010006085129123",
            "ReceiptTime": "",
            "ProcessStatus": "",
            "TransactionData": {
              "UniqueReference": "",
              "RelatedReferenceNumber": "",
              "AccountNumber": "204608015129123",
              "StatementNo": "",
              "TransactionTime": "",
              "CurrencyAmountCode": "",
              "OpeningBalance": {
                "DCMark": "",
                "Date": "",
                "Currency": "",
                "Amount":
              },
                "TransactionDetails": [],
                "ClosingBalance": {
                  "DCMark": "",
                  "Date": "",
                  "Currency": "",
                  "Amount": ""
                },
                "ClosingAvailableBalance": {
                  "DCMark": "",
                  "Date": "",
                  "Currency": "",
                  "Amount": ""
                },
                "Comment": "",
                "TotalNumberOfDebits": "",
                "TotalNumberOfCredits": ""
              }
            }
            ]
          }
        ]
      }
      }

Response description

JSON TagDescriptionData type
OSVAccoutStatementResponseRoot nodeObject
FromDateFrom DateString
ToDateTo DateString
TransactionTypeAlways it should be “940”String
OSVPaymentInfoMessageResponseElement root containing response of every bankObject
BankCodeName of the bank
Ex: “ALRAJHI”, “SABB”		String
CompanyCodeSender company code/Identifier provided by the bank during on-boardingString
B2BUrnUnique B2B reference numberString
B2BAggrIdUnique B2B aggregator identification detailsString
B2BUserIdUnique B2B user identification detailsString
StatusCodeStatus code of the processed requestString
StatusDetailStatus details of the processed requestString
ResponseItemCountNumber of transactions included in the statementString
TotalOpeningBalanceTotal Opening BalanceString
TotalClosingBalanceTotal Closing BalanceString
OSVPaymentInfoResponseThis tag contains the status of the Bank AccountsObject
TransactionTypeType of transactionString
StatusCodeStatus code of the transactionBoolean
StatusDetailStatus details of the transactionBoolean
SequenceNumUnique sequence number of the transactionString
AccountNumberAccount NumberString
ReceiptTimeReceipt Time of the EnquiryString
ProcessStatusStatus of the processString
TransactionDataTag carrying information on transaction detailsString
UniqueReferenceStatement reference numberString
RelatedReferenceNumberConcerned related reference numberString
AccountNumberAccount NumberString
StatementNoStatement NumberString
CurrencyAmountCodeCode of the currencyString
OpeningBalanceTag carrying information on opening balanceString
DCMarkCredit/Debit markString
DateDate of the credit and debit amountString
CurrencyAccount Currency. Maximum length of Currency should be 3. E.g. SARString
AmountAmountString
TransactionDetailsTag carrying information on transaction detailsString
ValueDateDate at which transaction is valuedString
EntryDateDate at which transaction is entered in the statememtString
PostingTimeTime of posting of the transaction statusString
DCMarkTransaction Credit/DebitString
FundsCodeCode of the fundsString
AmountCredit/Debit AmountString
TransactionTypeS: Swift Transfer
N: Non Swift Transfer
F: First Advice		String
IdentificationCodeUnique identification codeString
AccountOwnerReferenceAccount Owner Reference NumberString
BankReferenceBank Reference NumberString
DescriptionTransaction DescriptionString
SourceAccountSource AccountString
SourceIDSource IDString
SourceAccountNameSource Account NameString
CardTypeCard TypeString
BillerIdUnique SADAD biller identification detailsString
CategoryCategory of the transaction among Local Transfer, POS, BANK COMMISION, ATMString
VirtualAccountUnique virtual account identification detailsString
ClosingBalanceTag carrying information on closing balanceObject
DCMarkDC mark of the closing balanceString
DateDate of the indicated closing balanceString
CurrencyCurrency of the closing balance displayedString
AmountAmount denoting the closing balanceNumerical
ClosingAvailableBalanceTag carrying information on available closing balanceObject
DCMarkDC mark of the available closing balanceString
DateDate of the indicated available closing balanceString
CurrencyCurrency of the closing available balance displayedString
AmountAmount denoting the available closing balanceNumerical
CommentComment for the processString
TotalNumberOfDebitsNumber of debits included in the statementNumerical
TotalNumberOfCreditsNumber of credits included in the statementNumerical

Updated about 2 months ago