Loqate, a GBG solution

Getting started

Our address lookup is easy to install. There is no need for a developer or coding knowledge. You just need to be able to add a piece of code to your website and our video and quick setup guide below show you step by step how to do this.


Address Verification API

Use our API if you want to implement a bespoke solution.

Address Lookup API

Address Verification consists of two main API requests: a Find request is used to narrow down a possible list of addresses; and a Retrieve request is used to retrieve a fully formatted address.

View API   Go to Sandbox

    • Base URL

      Each API has a base URL on which the required data endpoint can be appended, such as json3.ws or xmle.ws. For SOAP, use wsdlnew.ws. See the endpoints section within each API for a full list of data options.

    • Authentication

      APIs require authentication in the form of a key, which can be created by adding a service in your account. Each key has its own security settings (URL & IP restriction, usage limits), and as many keys as necessary can be set up with these restrictions. A key must be passed to the API as a parameter in order for the request to authenticate, otherwise an error will be returned.

    • Common errors

      Each API has specific errors that may be returned, as well as a common set of errors relating to either account or key settings. See the list of common errors here.


Ultimate Implementation Guide

Ultimate Implementation Guide

Best practice tips for the optimal installation of address lookup.

Read the Ultimate Implementation Guide

FAQs on Address Lookup

  • How can I install address capture without a developer or technical know-how?

    Easy, you follow one of these three methods, and you will be validating addresses on your website in minutes.

    • Google Tag Manager

    If you are already using Google Tag Manager (GTM), this is a great way to add the Loqate tag code to your website. Once the tag is published, you are ready to continue the setup process through our quick setup guide.

    • Easy setup

    All you need to do is paste the Loqate tag code into the <head> section in the HTML of your website. Our quick setup guide shows you step-by-step what to do.

    • Pre-built integrations

    We provide a range of pre-built integrations so you can easily plug Loqate into some of the most popular eCommerce platforms and CRMS.

  • How do I get address lookups on my website?

    It's really easy to add Loqate to your website forms, we'll guide you through each step when you log in to your account. There's a small snippet of code to copy and paste onto your webpage. You can find this process detailed in our quick setup guide.

    To make the installation even easier, we've got several plugins for popular eCommerce and CRM platforms like Magento and Salesforce. 

  • Can I turn off browser autofill?

    Yes, for the best experience when using the Loqate address capture service, we recommend the browser autofill functionality is turned off for address form fields.
    Firstly, below where the Loqate Tag script has been placed on the page, insert the following JavaScript code snippet: 

    pca.on("load", function(type, id, control){
      var isChrome = !!window.chrome || !!window.chrome.webstore;
      if (isChrome == true){
        for (i=0; control.fields.length > i; i++){
          pca.getElement(control.fields[i].element).autocomplete = "PCATEST";

    On the Address Form Fields, we have found success in adding the attribute autocomplete="none", to disable the browser's autofill. For example: 

    <input id="Line1" type="text" autocomplete="none" placeholder="Start typing your address"  autofocus name=“searchTerm” />

    It is recommended to test this code across multiple popular web browsers. 

  • Can I find a postcode from an address, rather than the other way around?

    Yes, address lookup enables you to capture global addresses from a postcode. Or to search for a postcode or full address using any part of the address. The service can be used in a website or integrated into any application and is simple to set up and use.

  • Can I generate coordinates at property level?

    You can generate 'best guess' property level coordinates. The system will take a house number and a postcode, and predict where within the length of that postcode the property appears. As the data does not contain information on exactly where each house within a postcode lies, the results won’t always represent the exact property location. Geocoding at this level consumes an extra credit.

  • Do you have a free test postcode I can use?

    Yes, if you lookup our postcode WR5 3DA then credit will never be consumed when looking up the addresses in this postcode. However lookups with this postcode still require credits on the account. Please bear in mind this is a real postcode though.

  • Do you offer address lookups for countries worldwide?

    Yes, we provide address data for most countries around the world with data quality being improved continually. Our tool automatically detects the user's location to begin searching for local addresses.

  • How can I alter the county options in my drop-downs?

    Getting the right county for an address can be a surprisingly complex and contentious issue.

    Although many businesses still use the county field to identify sales areas, it is no longer required by Royal Mail as part of the address so is no longer supported by them.

    The county field problem stems from the late 1970s when there were a series of boundary changes, especially around London. In the mid 1990s the situation became even more complex with the introduction of unitary authorities around the major cities. The government recognises counties on the basis of administrative authority - for example, Derby isn't actually in Derbyshire - at least administratively speaking!

    Because Derby is a unitary authority, it is not administratively associated with Derbyshire, although it remains a geographic island within the county. Combine this complexity with the complete abolition of counties like Avon, and you can begin to understand that providing definitive County data is not as easy as it sounds.

    For each part of the country, there are actually three types of county listed: Administrative (the strict top level administrative unit), Former Postal (as used by the Royal Mail in the mid 90s but not updated since and including places like Avon) and finally Traditional (as used before all the changes in the 1970s).

    With this in mind, we have made significant changes to the county information that is provided by default as part of our service. Previously, we had taken the strict administrative approach, but we were aware that providing "Greater London" or "Cornwall and the Isles of Scilly" wasn't ideal. Therefore, from 26th July 2005, we changed the names that are returned to better reflect the county that is typically used in addressing.

    Summary of changes

    All unitary authorities will carry the county name of the geographic county they are situated in (e.g. Derby in Derbyshire etc.). London addresses will not carry the county information - for example, Greater London will be removed. This includes addresses with the postal town "London" and surrounding boroughs e.g. Wembley, Harrow etc. "Preserved" county names will be used for Wales. County names will be provided for 99% of mainland localities.


    If you have a specific requirement for using the former postal county, traditional county or admin county, these are still available through web services by calling the ListAliases method.

    County list

    • Aberdeenshire
    • Angus
    • Argyll and Bute
    • Bedfordshire
    • Berkshire
    • Buckinghamshire
    • Cambridgeshire
    • Cheshire
    • Clackmannanshire
    • Clwyd
    • Cornwall
    • Cumbria
    • Derbyshire
    • Devon
    • Dorset
    • Dumfries and Galloway
    • Durham
    • Dyfed
    • East Ayrshire
    • East Dunbartonshire
    • East Lothian
    • East Renfrewshire
    • East Riding of Yorkshire
    • East Sussex
    • Essex
    • Falkirk
    • Fife
    • Gloucestershire
    • Greater Manchester
    • Gwent
    • Gwynedd
    • Hampshire
    • Herefordshire
    • Hertfordshire
    • Highland
    • Inverclyde
    • Isle of Anglesey
    • Isle of Wight
    • Kent
    • Lanarkshire
    • Lancashire
    • Leicestershire
    • Lincolnshire
    • Merseyside
    • Mid Glamorgan
    • Midlothian
    • Moray
    • Norfolk
    • North Ayrshire
    • North Lanarkshire
    • North Yorkshire
    • Northamptonshire
    • Northumberland
    • Nottinghamshire
    • Orkney Islands
    • Oxfordshire
    • Perth and Kinross
    • Powys
    • Renfrewshire
    • Scottish Borders
    • Shetland Islands
    • Shropshire
    • Somerset
    • South Ayrshire
    • South Glamorgan
    • South Lanarkshire
    • South Yorkshire
    • Staffordshire
    • Stirlingshire
    • Suffolk
    • Surrey
    • Tyne and Wear
    • Warwickshire
    • West Dunbartonshire
    • West Glamorgan
    • West Lothian
    • West Midlands
    • West Sussex
    • West Yorkshire
    • Wiltshire
    • Worcestershire
  • How often is the UK address data updated?

    The Postcode Address File (PAF) ® data is owned and maintained by Royal Mail. We take and apply daily updates (around 5000 each day), to ensure the information you receive is as accurate as it is possible to be.

  • The address look-up service isn't returning the house name or number.

    Loqate offers both premise and street-level address look-ups. Premise-level address look-ups will return everything including the house name or number. The "street level" option will not return the house name or number. If you are not getting a house name or number when doing a lookup it may be the case you are either using a street-level licence or using one of our methods which return street-level data.

  • What benefits does international addressing provide?

    As well as validating overseas addresses, Loqate International allows you to choose the language and format for the country in question, e.g. Cyrillic script. This means that any mailings sent to foreign addresses will be in the appropriate format and language, reducing the likelihood of misspellings or causing offence. There are over 120 different address formats globally, and 30 different language scripts, so keeping global address data correct is no small task.

  • What countries does the service cover?

    For a full list of countries covered and data levels provided see Global Data Coverage.

  • Why do I have an address which is not returned when I do an address look-up?

    If you can't find an address, then the most likely reason is that it's new, and hasn't been added yet to the dataset. All our databases are updated regularly. As soon as the address has been added to the database, you should see the address reflected in our service. 

    If your property is not new please contact us and hopefully we'll be able to help. Remember, though, we can't make any actual changes to the data ourselves (because it's owned and maintained by third-party providers such as Royal Mail), so if an address is missing or incorrect you should contact the third-party directly.

  • Where does the data come from?

    We source our data from the best-in-class providers including official data providers such as: USPS, Canada Post, the UK's Royal Mail, Australia Post etc.

  • Do you offer international address verification?

    Yes. We offer the most comprehensive international solution on the market, and we are the only provider to curate our entire database of 245 countries and territories. You can learn more about our international address verification service here.

  • How do I remove certain countries from the dropdown on address lookup?

    You can adjust the available countries in your Key settings. Go to Menu > Your Services > Choose the specific Key > Click 'Customise' > Add the countries you would like to include in the address search, then save the changes. You will need to do this for each Key. 

  • How to configure your key settings

    Just a quick tip from us to configure each service key to your preferred settings. The settings are unique to each key, so you can activate different settings on each key.

    Go to Your Services and click on the relevant Key. 

    Under Configuration:

    • Give each key a unique name
      You can create separate keys for use on different websites or systems. We, therefore, recommend giving each key a unique name to help you identify where this key is being used, e.g. 'Main Checkout' or 'Website Delivery Address'.

    Under Limits:

    • Set lookup limits
      You can control the maximum number of lookups by setting a daily limit for lookups, a maximum number of lookups for each individual user, and/or restricting the service to specific URLs or IP addresses.

Technical Support

Our fully trained support team are on hand ready to answer any queries you may have 24 hours a day, 5 days a week. Give them a call on one of the numbers below or use live chat in your account section.

UK Support:

0800 198 6460

German Support:

0800 366 3347

US Support:

+1 (866) 642 3240

General Support:

(+44) 1905 915 084
(charged at local rate)


Sign up for a free trial or book a demo Get started