Verify IBAN details
SingleView IBAN verification API service checks whether an IBAN is correctly structured according to the international standard and verifies the correctness of the owner.
Endpoint URL | Method | Authentication requirements |
|---|---|---|
| POST |
|
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svibanValServiceRQ' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svibanValServiceRQ": {
"groupCode": "Enter_Group_Code",
"company": [
{
"companyCode": "Enter_Company_Code",
"userName": "Enter_Username",
"ibans": [
{
"iban": "Enter_IBAN",
"nationalId": "Enter_National_ID"
}
]
}
]
}
}'Request description
JSON Tag | Description | Data Type |
|---|---|---|
svibanValServiceRQ Mandatory | Tag carrying information on request for IBAN Validation service | Object |
groupCode Optional | Unique group identification code Length of input: Min 3 Characters Max 20 Characters | Numerical |
company Mandatory | Tag carrying information about company | Object |
companyCode Mandatory | Unique company identification code Length of input: Min 3 Characters Max 20 Characters | String |
userName Mandatory | Unique user identification name Length of input: Min 3 Characters Max 20 Characters | String |
ibans Mandatory | Tag carrying information on IBANs to be validated | Object |
iban Mandatory | Unique International Bank Account Number Length of the input: Max 24 Characters | String |
nationalId Mandatory | Unique national identification details of the provided IBAN's account owner Length of the input: Max 10 Digits | Numerical |
{
"svibanValServiceRS": {
"company": [
{
"companyCode": "Company_Code",
"userName": "Username",
"ibans": [
{
"TransactionReferenceNumber": "",
"StatusCode": "Status_Code",
"IsActive": "Active",
"StatusDetail": "Status_Details",
"InstitutionName": "Name_of_The_Institute",
"BeneficiaryNameMasted": "ABDU** ***",
"NationalId": "1010597589",
"IBAN": "SA8037446151848416184848",
"InstitutionStatus": "",
"BICCode": "",
"BankName": "SABB"
}
]
}
]
}
}Response description
JSON Tag | Description | Data Type |
|---|---|---|
svibanValServiceRS | Tag carrying information on process response for IBAN validation services | Object |
company | Tag carrying information on company | Object |
companyCode | Unique company identification code | String |
userName | Unique username | String |
ibans | Tag carrying information on validated IBANs in the response | Object |
TransactionReferenceNumber | Unique transaction reference number for the IBAN verification operation | String |
StatusCode | Validation status displayed via code | Numerical |
IsActive | Status of the account represented as | String |
StatusDetail | Validation status details | String |
InstitutionName | Name of the institution to whom the IBAN belongs | String |
BeneficiaryNameMasked | Name of the beneficiary masked in asterisks | String |
NationalId | Unique national identification details of the account owner | String |
IBAN | Unique IBAN of the beneficiary processed in the request | String |
InstitutionStatus | Status of the institution | String |
BICCode | Unique BIC code | String |
BankName | Name of the bank | String |