Address Validation

Fast and accurate UK postal address capture and completion.

This feature validates a postal address against the Royal Mail database. It will return either a single matching address result if an exact match is found; or a number of addresses if a partial match is found.

Service APIs

https://www.unifiedservices.co.uk/services/bankval/enhanced/bankvalnew

or

https://www.unifiedsoftware.co.uk/services/bankval/enhanced/bankvalnew

NB Please ensure that your code is able to failover between the two endpoints if a problem occurs.

The endpoints are identical. Either one can be used as primary or secondary.

Please contact us to obtain uname and pin credentials.

Sample request

(combined sort code and account validation plus address validation):

{credentials:{uname:myuserid,pin:12345},
account:{sortcode:"090126",account:"12345678"},
address:{address1:"Evolve Centre", postcode:"DH4 5QY"}}

Sample response

(combined sort code and account validation plus address validation):

{
   "validationID": "6e365c75-5e13-479c-beb2-971a0e50bbf1",
   "AddressVal":    [
            
            {
         "result": "VALID",
         "street": "Cygnet Way",
         "county": "Tyne and Wear",
         "postcode": "DH4 5QY",
         "organisation": "Evolve Centre",
         "addresscsv": "Evolve Centre, Cygnet Way, Houghton le Spring, Tyne and Wear, DH4 5QY",
         "posttown": "Houghton le Spring"
      }   
  
   ],
   "BankValUK":    {
      "ownbc": "0011",
      "subbranchsuffix": "00",
      "ccccretind": "",
      "fpsstatus": "M",
      "printminlocname": "",
      "transposedsortcode": "090126",
      "printcounty": "",
      "printsecentryind": "1",
      "printtelno2": "",
      "chapssclosedate": "",
      "bacssettsubsec": "02",
      "bacsredtoscode": "",
      "chapseswift": "",
      "ccccgbni": "GB",
      "bacssettbank": "0011",
      "printtelarea": "0800",
      "bacshandst": "01",
      "chapsestatus": "N",
      "bacsbsdisallowed": "",
      "printmajlocname": "LIVERPOOL",
      "printtelarea2": "",
      "fpsaccnumflag": "Y",
      "chapserbicbr": "",
      "fpssettbankbc": "0011",
      "printsecbrname": "",
      "supervisorybody": "A",
      "printtown": "MERSEYSIDE",
      "chapsesettmem": "",
      "result": "VALID",
      "printindicator": "0",
      "fpsredirecttosc": "",
      "chapsechangedate": "",
      "transposedaccount": "25727455",
      "bacsddiflg": "N",
      "fpshandbankct": "01",
      "chapssstatus": "I",
      "chapseretind": "",
      "ccode": "",
      "chapsschangedate": "17/12/2007",
      "chapssrbicbank": "ABBYGB3E",
      "ccccstatus": "M",
      "bacschangedate": "06/06/2005",
      "printaddr1": "",
      "bacsprdisallowed": "",
      "chapseclosedate": "",
      "printaddr4": "",
      "chapsretind": "",
      "printaddr3": "BOOTLE",
      "printaddr2": "BRIDLE ROAD",
      "ccccchangedate": "18/07/2017",
      "fpschangedate": "15/05/2009",
      "ccccclosedate": "",
      "sortcode": "090126",
      "bacsaccnumflag": "Y",
      "bacsredirectfrom": "",
      "spare4": "",
      "spare3": "",
      "changedate": "18/07/2017",
      "fpsspare1": "00",
      "spare5": "",
      "fpsspare3": "",
      "bacssettsec": "01",
      "fpsspare2": "00",
      "spare2": "",
      "spare1": "",
      "printbranchname": "BOOTLE CENTRE",
      "fpshandbankbc": "0011",
      "bacsdrdisallowed": "",
      "bacsclosedate": "",
      "owningbank": "Santander",
      "longbank1": "Santander UK plc",
      "chapserbicbank": "",
      "longbank2": "",
      "bacscrdisallowed": "",
      "fpsclosedate": "",
      "printmainsc": "",
      "bicbank": "",
      "printfbrtit1": "Santander Bank Account",
      "printpcode2": "4GB",
      "printfbrtit2": "",
      "ccccsettbank": "11",
      "printfbrtit3": "",
      "printpcode1": "L30",
      "bacscudisallowed": "CU",
      "bicbranch": "",
      "bacsdvdisallowed": "",
      "chapssrbicbr": "XXX",
      "ccccdasc": "000011",
      "printtelno": "0851785",
      "fpsredirectfrom": "",
      "chapsssettmem": "024",
      "deletedate": "",
      "fpssettbankct": "01",
      "fpsagencytype": "",
      "printbti": "M",
      "bacshandbank": "0011",
      "bacsaudisallowed": "",
      "bankname": "BANK ACCOUNT 1",
      "bacsstatus": "M"
   }
}

Please contact us to obtain uname and pin credentials.

Sample request

(address validation only):

{credentials:{uname:myuserid,pin:12345},
address:{address1:"Evolve Centre", postcode:"DH4 5QY"}}

Sample request

(address validation only):

{
   "validationID": "3408db76-81b2-45d8-9d88-5ea99ffcc012",
   "AddressVal":    [
      {
         "result": "VALID",
         "street": "Cygnet Way",
         "county": "Tyne and Wear",
         "postcode": "DH4 5QY",
         "organisation": "Evolve Centre",
         "addresscsv": "Evolve Centre, Cygnet Way, Houghton le Spring, Tyne and Wear, DH4 5QY",
         "posttown": "Houghton le Spring"
      }
           
   ]
}