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.
Free Trial
Get hands-on with our cloud based solutions. Contact us and we’ll set you up with a free trial today.
Service APIs
https://www.unifiedservices.co.uk/services/enhanced/bankvalnew
or
https://www.unifiedsoftware.co.uk/services/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"
}
]
}