Raw Statement

Retrieve raw statements provided by bank

Raw Statement API allows users to retrieve the original bank-issued account statement in its native format without transformation or normalization. Unlike structured statement APIs (which standardize data), this service returns the exact raw format provided by the bank, which may vary depending on the bank.

This API is typically used for retrieval of direct bank statement and reconciliation.

📘

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

Fetch Account Raw Statement

Endpoint details

Endpoint URL

Method

Grant type

/api/v2/account/rawstatement

POST

  1. CompanyId
  2. SVReferenceID
  3. DateTimeStamp
  4. Device
  5. Authorization: Bearer (Token)

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/v2/account/rawstatement' \
--header 'CompanyId: MYCOMPANY'
--header 'SVReferenceID: SV150619940615'
--header 'DateTimeStamp	:2026-02-11T10:20:39'
--header 'Device: Web'
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNMlZ4WGpFZmR6WFNWaTFad3B5QnlkOVpHelZXR2ZwUmFQNUV1TXl6S1Aybi94Y0lwR2V5STNNMkdPL1pqakd4ZG0yclJKUkdhRXlaWGNpWnZnOHArMWIyOGtOQTVkZ0VKajVVSEdiTmtNPSIsImlhdCI6MTczNTgwMTQ3NywiZXhwIjoxNzM1ODA1MDc3fQ.Bh7LFkvxNFrLe9dmH5rURWjGpES-u4z2EGeyrNM7z6E'
--header 'Content-Type: application/json' \
--data '{
"Message": {
  "OSVAccountStatementRequest": {
    "TransactionType": "940",
    "OSVPaymentInfoMessage": [
      {
        "AccNumber": "20432121234608512987",
        "BankCode": "BANKCODE",
        "FromDate": "2026-02-08T00:00:00",
        "ToDate": "2026-02-08T23:59:59",
        "CompanyCode": "123451234"
      }
    ]
  }
},
"Signature": "bufGtqdeocvK/mnsfRF4baLbKVY8tYXzBus9CmPar4IxZiWWAXkX9XQ6Jk3Lc8n/VoAioVQSl7vkvlbT+44K7HkuP/VQAY8zFJbaQM47Gv4QG/UPgkAZAlO5PcZj2yveuIVY1VBC2PMfjYRGG9zbPwCtLsiIj6tUp2oslQY+1MnBOLeO7xXtFX22Y7jsP9MxYEMLq1jyACLxBjEX7gz6mHYfuiEPFvN72E38+MaP4lYo1O+rRm+iUOF3Ak29UyNqk3oC5lts9bfWmYEMpVEobxf0wiqvhY1vKw5d7tvofXE2dkL/rWporceDRygSDaPo9O+QXbCdJENQdGA1kCCrQg=="
}'

Request description:

JSON Tag

Description

Data type

Message Mandatory

Header information (client credentials)

Object & String

OSVAccountStatementRequest Mandatory

Tag carrying information on request to fetch account statement

Object

TransactionType Mandatory

To be mentioned as 940

Numerical

OSVPaymentInfoMessage Mandatory

This tag contains multiple banks requests

Object

AccNumber Mandatory

Unique account number for which the account statement is requested Input size: Min - 11 Characters Max - 24 Characters

Alphanumeric

BankCode Mandatory

Unique bank identification code (SingleView Identifier) Ex: ALRAJHI, SABB, BSF, ANB, NCB, ALINMA, GIB, RIYADH, ALBI, BJAZ

Alphabetical

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

CompanyCode Mandatory

Sender company code/Identifier provided by the bank during on-boarding

String

Signature Mandatory

Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)

String

Sample response

<?xml version='1.0' encoding='UTF-8'?>
<PaymentInfoMessageResponse>
<PaymentInfoResponse>
<Comment>No Comment</Comment>
<TransactionType>940</TransactionType>
<ReceiptTime>2026-02-11T10:20:40</ReceiptTime>
<ProcessStatus>1</ProcessStatus>
<TransactionData>:20:20260109080012                                               
:25:20432121234608512987                                              
:28C:00008/001                                                   
:60F:C260108SAR3669990,09                                        
:61:2601080108DR10,00NTRF2601648130011 26//202601089000001       
:86:/PT/Local Payment Order 2601648130011-2601648130011B2B/TOACCT
/SA8081234204608012123123new global company alrajhi three/A2A         
:61:2601080108DR520,00NTRF2601648180011 26//202601089000002      
:86:/PT/Local Payment Order 2601648180011-2601648180011B2B/TOACCT
/SA338998765471099123451212121/A2A                               
:61:2601080108CR520,00NTRF2601648180011 26//202601089000003      
:86:/PT/SARIE  Inward Payments 2601648180011-2601648180011B2B REJ
-/TOACCT/SA0581234204608015129115Al Rajhi B2B              
:62F:C260108SAR3669980,09</TransactionData>
<SequenceNum>1</SequenceNum>
<AccountNumber>20432121234608512987</AccountNumber>
</PaymentInfoResponse>
<ResponseItemCount>1</ResponseItemCount>
<StatusDetail>OK</StatusDetail>
<StatusCode>OK</StatusCode>
<CompanyCode>123451234</CompanyCode>
</PaymentInfoMessageResponse>

Response description

Raw statement comprises of various tags that differ based on the bank. The following are the common tags generally used in the business use cases:

JSON TagDescriptionData type
:20:Reference assigned by the bank for message identificationAlphanumeric
:25:Account numberAlphanumeric
:28C:Statement number/Sequence numberNumeric
:60F: or :60M:Opening balanceNumeric
:61:Payment information like value date, credit/debit date, etc.String
:86:Transaction description/narrativeString
:62F: or :62M:Closing balanceNumeric