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
Environment Domain Rate/Limit Sandbox sandboxapi.onesingleview.com 10 Calls per Minute Production/LIVE To be provided upon onboarding Based on contract
Fetch Account Raw Statement
Endpoint details
Endpoint URL | Method | Grant type |
|---|---|---|
| POST |
|
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 | 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 Tag | Description | Data type |
|---|---|---|
| :20: | Reference assigned by the bank for message identification | Alphanumeric |
| :25: | Account number | Alphanumeric |
| :28C: | Statement number/Sequence number | Numeric |
| :60F: or :60M: | Opening balance | Numeric |
| :61: | Payment information like value date, credit/debit date, etc. | String |
| :86: | Transaction description/narrative | String |
| :62F: or :62M: | Closing balance | Numeric |
Updated 3 days ago