t: +44 (0)191 305 5035  e: info@unifiedsoftware.co.uk 

GetABADetails

Important note.

All BankVal web services are available on both the main and backup servers at our primary data centre. This configuration is mirrored at our secondary data centre. The two data centres are geographically independent. Using this configuration, the BankVal web service has been available continuously since launch in 2003.

In general:

• Call the service at the primary data centre at www.unifiedsoftware.co.uk
• In the unlikely event of a failure, call the service at the secondary data centre at www.unifiedservices.co.uk

1 GetABADetails - REST implementation

The GetABADetails service performs the following functions:

• Validates any USA ABA Routing Number.
• If ABA number is valid, returns bank information.

Follow these three steps:-

• 1. Attempt to access the service on unifiedsoftware.co.uk
• 2. Check the http response code
• 3. If this is < 200 or > 399, access the backup service on unifiedservices.co.uk

URI for GetABADetails

• GET https://www.unifiedsoftware.co.uk/services/bankvalint/abadetails/userid/‹userid›/pin/‹pin›/aba/‹aba›/‹format›/

where:

• ‹userid› and ‹pin› are your user ID and 5 digit PIN obtained upon registration at:
  www.unifiedsoftware.co.uk/free-trial/free-trial-home.html
• ‹aba› is the ABA Routing Number to be validated.
• ‹format› specifies the format of the returned data. Valid formats are csv, xml and json. (csv uses the "|" delimiter)

Results

If aba is valid:-

• First field - contains word VALID
• Remaining fields - contain data about the bank i.e. Routing Number | Bank Name | Bank Address |
  City | State | ZIP Code | Phone Number | Area Code | FIPS | Time Zone | DST | Latitude |
  Longitude | MSA | PMSA | County

Example Valid Results

If routing number is not valid or if an error occurs:-

• First field - contains error message
• xml, json - remaining fields are empty
• csv - no other fields returned

Error messages :-

<< Back to Top >>

2 GetABADetails - SOAP implementation

The GetABADetails service performs the following functions:

• Validates any USA ABA Routing Number.
• If ABA number is valid, returns bank information.

Parameter Format for GetABADetails

ReturnMessage = getabadetails(QueryString)

where

QueryString is a " | " delimited string of the format "userID|PIN|ABA Routing Number"

ReturnMessage is either the string "INVALID" OR "ERROR - ..." OR

a 17 field string that is delimited by " | " characters in the format :-

VALID | Routing Number | Bank Name | Bank Address | City | State | ZIP Code | Phone Number | Area Code | FIPS | Time Zone | DST | Latitude | Longitude | MSA | PMSA | County

All possible ReturnMessage values are shown below

WSDL files

The WSDL file on the primary data centre is at www.unifiedsoftware.co.uk/BankValinternationalall.wsdl

The WSDL file on the backup data centre is at www.unifiedservices.co.uk/BankValinternationalall.wsdl

<< Back to Top >>