Street Address Search functionality:
To get a Street address from our HTTP/XML Web Service we do the following:
Simply use the "Sign Up for Trial" link at top right of this page to open a trial account. We will then send you a data key, which is used to identify your account, when using the following service.
Call XMLService/XMLSearchForThoroughfareAddress.aspx to get address record
XMLService/XMLSearchForThoroughfareAddress.aspx
This call will retrieve the Thoroughfare/Street Address Data (Royal Mail Street PAF) for a given Postcode. The Street Address is a cut down version of the Full Address, basically it does not contain the Building name or number. Therefore the programmer should allow the user to enter the House Name/Number for the address. These licenses are cheaper than Full Postcode data.
Call HTTP web service with your data key, which is e-mailed to you when you open an account. The data key identifies your account and licenses.
Web Service www.simplylookupadmin.co.uk/XMLservice/XMLSearchForThoroughfareAddress.aspx?datakey=Your Data Key &postcode=pe132ql&version=2
www.simplylookupadmin.co.uk/XMLservice/XMLSearchForThoroughfareAddress.aspx?datakey=Your Data Key &postcode=pe132ql&version=2
Returns XML <?xml version="1.0" encoding="utf-8" standalone="yes" ?> <!DOCTYPE data [ <!ELEMENT data(found,credits_ display_text, accountadminpage, errormessage,record)> <!ELEMENT found (#PCDATA)> <!ELEMENT credits_display_text (#PCDATA)> <!ELEMENT accountadminpage (#PCDATA)> <!ELEMENT errormessage (#PCDATA)> <!ELEMENT record (line1,line2,line3,town,county,postcode, country, rawpostcode, mailsortcode, spare)> <!ELEMENT line1 (#PCDATA)> <!ELEMENT line2 (#PCDATA)> <!ELEMENT line3 (#PCDATA)> <!ELEMENT town (#PCDATA)> <!ELEMENT county (#PCDATA)> <!ELEMENT postcode (#PCDATA)> <!ELEMENT country (#PCDATA)> <!ELEMENT rawpostcode (#PCDATA)> <!ELEMENT mailsortcode (#PCDATA)> <!ELEMENT spare (#PCDATA)> ]> <found>1</found> <errormessage></errormessage> <credits_display_text>Evaluation expires 28 Jul 2010</credits_display_text> <accountadminpage>https://www.xxx...</accountadminpage> <errormessage></errormessage> <record> <line1>Vicrotia Rd</line1> <line2></line2> <line3></line3> <town>Wisbech</town> <county>Cambridgeshire</county> <postcode>PE13 2QL</postcode> <country>England</country> <rawpostcode>PE132QL</rawpostcode> <mailsortcode>1033</mailsortcode> <spare></spare> </record> </data>
<?xml version="1.0" encoding="utf-8" standalone="yes" ?> <!DOCTYPE data [ <!ELEMENT data(found,credits_ display_text, accountadminpage, errormessage,record)> <!ELEMENT found (#PCDATA)> <!ELEMENT credits_display_text (#PCDATA)> <!ELEMENT accountadminpage (#PCDATA)> <!ELEMENT errormessage (#PCDATA)> <!ELEMENT record (line1,line2,line3,town,county,postcode, country, rawpostcode, mailsortcode, spare)> <!ELEMENT line1 (#PCDATA)> <!ELEMENT line2 (#PCDATA)> <!ELEMENT line3 (#PCDATA)> <!ELEMENT town (#PCDATA)> <!ELEMENT county (#PCDATA)> <!ELEMENT postcode (#PCDATA)> <!ELEMENT country (#PCDATA)> <!ELEMENT rawpostcode (#PCDATA)> <!ELEMENT mailsortcode (#PCDATA)> <!ELEMENT spare (#PCDATA)> ]> <found>1</found> <errormessage></errormessage> <credits_display_text>Evaluation expires 28 Jul 2010</credits_display_text> <accountadminpage>https://www.xxx...</accountadminpage> <errormessage></errormessage> <record> <line1>Vicrotia Rd</line1> <line2></line2> <line3></line3> <town>Wisbech</town> <county>Cambridgeshire</county> <postcode>PE13 2QL</postcode> <country>England</country> <rawpostcode>PE132QL</rawpostcode> <mailsortcode>1033</mailsortcode> <spare></spare> </record> </data>
If address returned then found = 1, else found = 0,error in errormessage
found = 1
found = 0
errormessage
errormessage should be displayed if populated
It is a requirement of the royal mail that if postcode lookup software is used by an employee of a company, then the user must be uniquely identified so we can apply a user count.
Therefore the URL must contain a User ID:
www.simplylookupadmin.co.uk/XMLservice/XMLSearchForThoroughfareAddress.aspx?datakey=Your Data Key &postcode=pe132ql&version=2&username=UserID
This will be the datakey beginning with "I"
Section 3.5 of the Terms and Conditions state: "The Customer, when using the Postcode Lookup service via Web Service, must make sure each user is identified by a unique Computer name, in each call to the Web Service if used internally”. In simple language this means that each user must be identified by a unique computer name, in username parameter, if used by a company employee.
Final step is to test, to enable easy testing please use our special test postcodes.
This type of license returns: (see example below)