Western Union Business Solutions Logo

Get Started

Get Started

Search Bank by Details

Resource Template 
                            /bank/searchbydetail
Http Method POST
Description Returns Bank Details which match the input fields
Input 
                            {




bic" : "<bic code>","nationalId" : "<National Id>","isoCountryCode" :




 "<ISO Country Code>","countryName" : "<Country Name>","city" :




 "<City>","streetAddress1" : "<Street Address 1>","zipCode" :




 "<Zip Code>","state" : "<State>","CurrencyCode" :




 "<Currency Code>","pageNumber" : <Requested Page NUmber>,




"pageSize" : <Requested Page Size>




}





 Sample Input -




{




"bic":"RBOSGB2L","countryName": "UNITED KINGDOM",




"pageNumber": 1,"pageSize" : 2




}

Note: Some input fields are optional
Input Validation

Input can be

  1. mbic + isoCountryCode/CountryName
  2. nationalId + isoCountryCode/CountryName
  3. isoCountryCode/CountryName + city + instituionaName + 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", "bic": "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", "isoCountryCode":
"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. - 'BIC and any one other parameter (isoCountryCode/CountryName)' OR 
2. - 'NationalId and any other parameter (isoCountryCode/CountryName)' OR 
3. - '(isoCountryCode/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"




 }