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": {
    "groupCode": "Group_Code",
    "company": [
      {
        "companyCode": "Company_Code",
        "userName": "Username",
        "ibans": [
          {
            "BankCode": "Bank_Code",
            "StatusCode": "Status_Code",
            "StatusDetail": "Status_Details",
            "BICCode": "BIC_Code",
            "InstitutionName": "Name_of_The_Institute",
            "StreetAddress1": "Street_Address_Line_1",
            "StreetAddress2": "Street_Address_Line_2",
            "StreetAddress3": "Street_Address_Line_3",
            "ChipsId": "Chips_ID",
            "Branch": "Branch_Info",
            "RecordKey": "Record_key",
            "OfficeType": "Office_Type",
            "ParentOfficeKey": "Parent_Office_Key",
            "HeadOfficeKey": "Head_Officie_Key",
            "InstitutionStatus": "Institution_Status"
          }
        ]
      }
    ]
  }
}

Response description

JSON Tag	Description	Data Type
svibanValServiceRS	Tag carrying information on process response for IBAN validation services	Object
groupCode	Unique group identification code	Numerical
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
BankCode	Unique bank identification code	String
StatusCode	Validation status displayed via code	Numerical
StatusDetail	Validation status details	String
BICCode	Unique BIC code	String
InstitutionName	Name of the institution to whom the IBAN belongs	String
StreetAddress1	Street address line 1 of the account owner as per bank records	String
StreetAddress2	Street address line 2 of the account owner as per bank records	String
StreetAddress3	Street address line 3 of the account owner as per bank records	String
NationalId	Unique national identification details of the account owner	Numerical
ChipsId	Unique CHIPS identification	String
Branch	Unique branch identification details	String
RecordKey	Unique record key	String
OfficeType	Details on type of office	String
ParentOfficeKey	Unique details on parent office key	String
HeadOfficeKey	Details on head office key	String
InstitutionStatus	Status of the institution	String