Simple APIs for UK Addresses
Autocomplete, Postcode Lookup, Typeahead, Location, Calculate Distance
Get started for freeThe High Court of England & Wales held on 10 October 2025 that address data used by the GetAddress service infringes the intellectual property rights of Royal Mail Group Limited and IDDQD Limited. Details of the Court’s findings can be found in its judgment, which is published on the National Archives case law website at https://caselaw.nationalarchives.gov.uk/ewhc/ch/2025/2561. The copying (even internally) or making available of address data from the GetAddress service by GetAddress customers may, depending on the specific facts, also infringe the intellectual property rights of Royal Mail Group Limited and IDDQD Limited. This notice has been prepared pursuant to paragraph 16 of the Court’s Order dated 6 November 2025”.
Features
Easy to use libraries
<label>First Address Line</label>
<input id="formatted_address_0" type="text">
<label>Second Address Line</label>
<input id="formatted_address_1" type="text">
<label>Third Address Line</label>
<input id="formatted_address_2" type="text">
<label>Town</label>
<input id="town_or_city" type="text">
<label>County</label>
<input id="county" type="text">
<label>Postcode</label>
<input id="postcode" type="text">
<script src="https://cdn.getaddress.io/scripts/getaddress-autocomplete-3.1.6.js"></script>
<script defer>
const enableAutocomplete = async ()=>
{
await getAddress.autocomplete('formatted_address_0','API KEY or DOMAIN TOKEN',
{
selected : (address) => {
document.getElementById('formatted_address_0').value = address.formatted_address[0];
document.getElementById('formatted_address_1').value = address.formatted_address[1];
document.getElementById('formatted_address_2').value = address.formatted_address[2];
document.getElementById('town_or_city').value = address.formatted_address[3];
document.getElementById('county').value = address.formatted_address[4];
document.getElementById('postcode').value = address.postcode;
}
});
}
enableAutocomplete();
</script>
Autocomplete
Add as-you-type address completion to any HTML form.
<!-- container -->
<div id="postcode_lookup"></div>
<label>First Address Line</label>
<input id="formatted_address_0" type="text">
<label>Second Address Line</label>
<input id="formatted_address_1" type="text">
<label>Third Address Line</label>
<input id="formatted_address_2" type="text">
<label>Town</label>
<input id="town_or_city" type="text">
<label>County</label>
<input id="county" type="text">
<label>Postcode</label>
<input id="postcode" type="text">
<script src="https://cdn.getaddress.io/scripts/getaddress-find-2.1.0.min.js">
</script>
<!-- after your form -->
<script>
getAddress.find('postcode_lookup','API KEY or DOMAIN TOKEN');
</script>
Find
Add postcode lookup to any HTML form.
<label>Postcode Example:</label>
<input id="typeahead-postcode" type="text">
<label>Town or City Example:</label>
<input id="typeahead-town-or-city" type="text">
<label>County Example:</label>
<input id="typeahead-county" type="text">
<label>Country Example:</label>
<input id="typeahead-country" type="text">
<script src="https://cdn.getaddress.io/scripts/getaddress-typeahead-1.1.0.min.js">
</script>
<!-- after your form -->
<script>
getAddress.typeahead('typeahead-postcode','postcode','API KEY or DOMAIN TOKEN');
getAddress.typeahead('typeahead-town-or-city','town_or_city','API KEY or DOMAIN TOKEN');
getAddress.typeahead('typeahead-county','county','API KEY or DOMAIN TOKEN');
getAddress.typeahead('typeahead-country','country','API KEY or DOMAIN TOKEN');
</script>
Typeahead
Improve the user experience by supplying a list of possible choices.
<input id="location-textbox" type="text">
<script src="https://cdn.getaddress.io/scripts/getaddress-location-1.1.0.min.js">
</script>
<script>
getAddress.location('location-textbox','API KEY or DOMAIN TOKEN');
document.addEventListener("getaddress-location-selected", function (e) {
updateGoogleMap(e.location.latitude,e.location.longitude);
});
</script>
Location
Add as-you-type location completion to any HTML form.
FAQ
- Autocomplete queries are rate limited but do not increase your usage*.
- Resolving an autocomplete suggestion counts as 1 look-up.
- Typeahead queries are rate limited but do not increase your usage.
- A distance query counts as 2 look-ups.
- *Autocomplete queries with only postcode and parameter:all=true count as 1 look-up.
- *Autocomplete queries with parameter:show-postcode=true count as 1 look-up.
Public sector information licensed under the Open Government Licence v3.0.