Western Union Business Solution is rebranding into CONVERA Read more >

Search Bank by Details

Resource Template
                            
/bank/searchbydetail
                
                          
Http Method POST
Description Returns Bank Details which match the input fields
Input
                            
{bankCode" : "<BIC or SWIFT code>",
"nationalId" : "<National Id>","countryCode" :
"<2-character ISO Country Code>",
"countryName" : "<Country Name>","city" :
"<City>","streetAddress1" : "<Street Address 1>"
,"zipCode" :"<Zip Code>","state" : "<State>",
"bankName" : "<bank name>","CurrencyCode" :"<Currency Code>",
"pageNumber" : <Requested Page NUmber>,
"pageSize" : <Requested Page Size>}
                          

                            
Sample Input - {"bankCode":"RBOSGB2L","countryName": "UNITED KINGDOM", 
"pageNumber": 1,"pageSize" : 2}
                          

Note: Some input fields are optional

Input Validation

Input can be

  1. bankCode + countryCode OR countryName
  2. nationalID + countryCode OR countryName
  3. countryCode / countryName + city + bankName + any other params
Output
                            200 OK
Sample Output -
{"httpStatus": "200", "timestamp": "01/17/2020 04:12:45",
"responseStatus": "SUCCESS", "totalRecordFound": "1",
"totalRecordSent": "1","banks":
 [
 {"BankDirectory": { 
"recordKey": "BD0000001OZF","officeType": "HO","parentOfficeKey":
"BD0000001T83", >"headOfficeKey": "BD0000001T83", "legalType": "L",
"legalParentKey": "BD0000001T83", "groupType": "Member", 
"groupParentKey":"BD0000001QG0", "institutionStatus": "COOP", 
"isoleiCode": "529900XTU9H3KES1B287","bic8Char": "SGSBALTX", 
"branchBic": "XXX", "bandCode": "SGSBALTXXXX", "connectedBic":
 "SGSBALTXXXX", "institutionName":"RAIFFEISEN BANK SH.A.", 
 "branchInformation":"Head Office 1, 2,", 
 "streetAddress1": "RR 'DESHMORET E 4 SHKURTIT' 6",
"city": "TIRANA", "countryProvinceState": "TIRANA", 
"zipCode": "1001","countryName": "ALBANIA", "countryCode":
"AL", "timezone": "T", "subTypeIndicator": "SUPE",
"networkConnectivity":"CCC", "serviceCodes": 
"AIPEB+FINSCOTG+","ssiGroupKey": "BD0000001T83",
"iBanKey": "IB000000001T", "nationalIdType": "NBA"
}"OfficeType": {
 "officeTypeCode":"HO", "officeTypeDescription": 
 "Head Office"
 },
"LegalType":{
"legalTypeCode": "L",
"legalTypeDescription":"Legal Entity"
 },
 "InstitutionStatus":{
 "instStatusCode": "COOP",
 "instStatusDesc": "Cooperative Bank",
 "instStatusParent": "BANK"
 }}]}
                               
  Note: For more details for each output field, please refer the Bank Directory Plus pages.

Output - Validation Error - Request body is not sent (Request body is null)

                            400 Bad Request     
{"errorCode": "1003:Request data should not be null"}
                           
                          

Output - Validation Error - Request body sent but some some mandatory field is missing (Validation failed) - Check the validation mentioned above

                            400 Bad Request
{"errorCode": "1003Request data can be 
1. - 'bankCode and any one other parameter (countryCode/CountryName)' OR 
2. - 'NationalId and any other parameter (countryCode/CountryName)' OR 
3. - '(countryCode/CountryName) and city and institutionName' "}                      
                          
Output - FAB Service Error - when requested bank account was not found
                            400 Bad Request
{"errorCode": "1222:Error in FAB Service - response_message :
No records found that match the details provided.
and field_name and response code - Err1015"}
                          
Output- FAB Service Error - When Wrong input request data sent (Wrong Country Code or any other field)
                            400 Bad Request
{"errorCode": "1222:"1222:Error in FAB Service - response_message :
The country (country code/country name) provided is invalid.
and field_name iso_country_code and response code - Err1011"}