IBAN Validation

Verify and validate IBAN details

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 URLMethodAuthentication requirements
/v1/api/erp/svibanValServiceRQPOST1/. clientid
2. clientsecret
3. signature

Validate IBAN Service

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 TagDescriptionData 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-256String
svibanValServiceRQ
Mandatory
Tag carrying information on request for IBAN Validation serviceObject
groupCode
Optional
Unique group identification code
Length of input:
Min 3 Characters
Max 20 Characters
Numerical
company
Mandatory
Tag carrying information about companyObject
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 validatedObject
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",
            "City": "City",
            "ZipCode": "ZIP_Code",
            "NationalId": "National_ID",
            "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 TagDescriptionData Type
svibanValServiceRSTag carrying information on process response for IBAN validation servicesObject
groupCodeUnique group identification codeNumerical
companyTag carrying information on companyObject
companyCodeUnique company identification codeNumerical
userNameUnique usernameString
ibansTag carrying information on validated IBANs in the responseObject
BankCodeUnique bank identification codeString
StatusCodeValidation status displayed via codeNumerical
StatusDetailValidation status detailsString
BICCodeUnique BIC codeString
InstitutionNameName of the institution to whom the IBAN belongsString
StreetAddress1Street address line 1 of the account owner as per bank recordsString
StreetAddress2Street address line 2 of the account owner as per bank recordsString
StreetAddress3Street address line 3 of the account owner as per bank recordsString
CityCity of the account owner as per bank recordsString
ZipCodeZIP code of the account owner as per bank recordsNumerical
NationalIdUnique national identification details of the account ownerNumerical
ChipsIdUnique CHIPS identificationString
BranchUnique branch identification detailsString
RecordKeyUnique record keyString
OfficeTypeDetails on type of officeString
ParentOfficeKeyUnique details on parent office keyString
HeadOfficeKeyDetails on head office keyString
InstitutionStatusStatus of the institutionString