SingleView IBAN validation API service checks whether an IBAN is correctly structured according to the international standard and verifies the correctness of the owner.

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svibanValServiceRQ`	POST	1. `clientid` 2. `clientsecret` 3. `signature`

Validate IBAN Service

Try in API Reference ➜

Sample request

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
clientid Mandatory	Unique client identification details Length of input: Min 3 Characters Max 20 Characters	String
clientsecret Mandatory	Unique client secret code Length of input: Min 3 Characters Max 20 Characters	String
signature Mandatory	64-Bit string obtained by processing client signature key through Base-64 and SHA-256	String
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	Numerical
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

Sample response

{
  "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	Numerical
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 `Active` or `Inactivae`	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