Validate and verify International Bank Account Numbers (IBANs)
SingleView IBAN Verification API services validates the IBANs with account information in real-time promoting payment efficiency and reducing payment errors and frauds service.
IBAN Verification helps confirm that the provided IBAN is valid and belongs to the right person.
🌐 Domain details
Environment
Domain
Rate/Limit
Sandbox
3 Calls per Day
Production/LIVE
To be provided upon onboarding
Based on contract
Endpoint URL | Method | Authentication requirements |
|---|---|---|
| POST |
|
curl --location 'https://sandboxapi.onesingleview.com/api/v1/getbeneficary/bankdetails' \
--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": {
"OSVBeneficiaryBankDetailsRequest": {
"OSVBeneficiaryBankDetails": [
{
"NationalId": "1350011923",
"IBANAccount": "SA2015587976172154821147"
}
]
}
},
"Signature": "UMEH9M8tXknuRnnkrzRjDHaxFRLyZJ+wDNAl408+nTWyfTKaVcBkLLPhX5DKjTX18HK/oEJ8rmSeoswQuKzk9F2WIcXwZI9C+h7GA5d6r0FEu9hAYG+tDjFSyPDPHunMbILe1rgIlenbHra24Xt2IxAqj5115FEhJyabV0saIveNfK4sPOWtB+HeEAhwP6pwHETZoO4Z9kiMgdIbBbyD43IpRyxVQzogtlNKrkRaW/k16eIGzeS8Nh5g0txEoa3aocQTiVqzEtkwBXMKKUnoMZMCIOsPh7XNDN9nmsad0CNHr5wwJZoc9gC2e/d7fWuUu8xqe8AaSWXm3xTIfostIg=="
}'Request parameters
JSON Tag |
Requirement | Description | Data type |
|---|---|---|---|
Message | Mandatory | Request body | Object & String |
OSVBeneficiaryBankDetailsRequest | Mandatory | Root tag carrying information on the IBAN verification request | Object |
OSVBeneficiaryBankDetails | Mandatory | Tag containing information on the bank and IBAN details for the request | Object |
IBANAccount | Mandatory | Unique IBAN information Length of input: 24 Characters | String |
NationalId | Mandatory | Unique national identification of the account holder (Iqama, CR number or National Id) | String |
Signature | Mandatory | Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature) | String |
{
"OSVBeneficiaryBankDetailsResponse": {
"BeneficiaryBankDetailsMessage": [
{
"TransactionReferenceNumber": "",
"StatusCode": "Success",
"IsActive": "Active",
"StatusDetail": "Success",
"BICCode": "INMASARI",
"InstitutionName": "M*******",
"BeneficiaryNameMasked": "M*******",
"NationalId": "135001192",
"IBAN": "SA2015587976172154821147",
"BankName": "Alinma Bank",
"thumbnail": "/images/AlinBankthumb.png"
}
]
}
}Response parameters
JSON Tag | Description | Data type |
|---|---|---|
OSVBeneficiaryBankDetailsResponse | Tag carrying information on the response for IBAN Verification | Object |
BeneficiaryBankDetailsMessage | Tag carrying information on the requested IBANs for verification | Object |
TransactionReferenceNumber | Unique identification details about the transaction for IBAN verification | Alphanumeric |
StatusCode | Information on verification process as | Boolean |
IsActive | Status of the mentioned IBAN as | Boolean |
StatusDetail | Details about the status response | String |
BICCode | Unique Bank Identification/Identifier Code | Alphanumeric |
InstitutionName | Beneficiary name/Institution name representing the IBAN | String |
BeneficiaryNameMasked | Beneficiary name displayed with masked characters | String |
NationalId | Unique identification details of the account owner that can be Iqama, CR number or National Id | Numeric |
IBAN | Returning of the provided IBAN in the request | Alphanumeric |
BankName | Name of the bank associated with the IBAN | String |
thumbnail | A small image of the institution logo | File |