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 URL | Method | Authentication requirements |
---|---|---|
/v1/api/erp/svibanValServiceRQ | POST | 1. 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 Tag | Description | Data Type |
---|---|---|
clientid Mandatory | Unique client identification | String |
clientsecret Mandatory | Unique client secret key | String |
signature Mandatory | 64-Bit encrypted signature code | String |
svibanValServiceRQ Mandatory | Tag carrying information on request for IBAN Validation service | Object |
groupCode Mandatory | Unique group code | Numerical |
company Mandatory | Tag carrying information about company | Object |
companyCode Mandatory | Unique company code | Numerical |
userName Mandatory | Unique user identification name | String |
ibans Mandatory | Tag carrying information on IBANs to be validated | Object |
iban Mandatory | Unique International Bank Account Number | String |
nationalId Mandatory | Unique national identification details of the provided IBAN's account owner | 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 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 |
City | City of the account owner as per bank records | String |
ZipCode | ZIP code of the account owner as per bank records | Numerical |
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 |
Updated 2 months ago