Open BankingB2B SuiteERP Integration
GuidesChangelog
Menu

Categories

Open BankingB2B SuiteERP Integration


  • GENERAL INFORMATION

    • Documentation guide
    • Documentation guide
    • SingleView B2B Core APIs
    • SingleView Open Banking
    • Platform architecture
    • KSAOB standards
    • Security best practices
  • Getting started

    • Introduction
    • Become a User
    • Quick Lookup
  • GETTING STARTED

    • Integration guide
    • Become a user
    • Integration guide
    • Prerequisites for Sandbox
    • Developer console
    • Establishing secure connection
    • Establish secure connection
    • Authenticating your request
    • Generate access token
    • Making your first test api call
    • Make test raw data API call
    • Prerequisites for production
    • Make test data use case API call
    • Moving to production
  • Authentication

    • Generate Signature
  • ERP API Services

    • Configure API Account
    • Create Group & Company
    • Supplier Services
    • Account Services
    • Balance Enquiry
    • Statements
    • IBAN Validation
    • POS Transactions
  • CONSENT MANAGEMENT

    • Overview
    • Create a consent
    • Retrieve consent details
    • Revoke a consent
  • AUTHENTICATION

    • Header parameters
    • Obtain access token
    • Generate signature
  • Data APIs

    • Account statement
    • Balance enquiry
    • IBAN verification
    • POS transactions
    • Raw statement
  • Raw Data APIs

    • Introduction
    • View accounts
    • View balance
    • View transactions
    • Identify account holders (Parties)
    • Review direct debits
    • Review scheduled payments
    • Review standing orders
  • Payment APIs

  • DATA USE CASE APIS

  • SADAD

  • Plug-and-Play Integrations

    • Payly
  • RESOURCES

    • POR Details
    • Error codes
    • Errors & codes
    • Collections
    • API version management
    • Bank connectivity
  • API Archives


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
  • Raw statement can only be provided for a single day

🌐 Domain details

Environment

Domain

Rate/Limit

Sandbox

sandboxapi.onesingleview.com

3 Calls per Day

Production/LIVE

To be provided upon onboarding

Based 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

Fetch Account RAW Statement 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 parameters

JSON Tag

Requirement

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

Fetch Account Raw Statement 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 parameters

Raw statement comprises of various tags that differ based on the bank. The following are the common tags generally used and their details:

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 June 26, 2026

Was this helpful?