Simple APIs for UK Addresses
Autocomplete, Postcode Lookup, Typeahead, Location, Calculate Distance
Get started for free{
"postcode": "SW1A 2AA",
"latitude": 51.503038,
"longitude": -0.128371,
"addresses": [
{
"formatted_address": [
"Prime Minister & First Lord of the Treasury",
"10 Downing Street",
"",
"London",
""
],
"thoroughfare": "Downing Street",
"building_name": "",
"sub_building_name": "Prime Minister & First Lord of the Treasury",
"sub_building_number": "",
"building_number": "10",
"line_1": "Prime Minister & First Lord of the Treasury",
"line_2": "10 Downing Street",
"line_3": "",
"line_4": "",
"locality": "",
"town_or_city": "London",
"county": "",
"district": "Westminster",
"country": "England"
}
]
}
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-2.0.2.min.js">
</script>
<!-- after your form -->
<script>
const autocomplete = getAddress.autocomplete('formatted_address_0','API KEY or DOMAIN TOKEN');
autocomplete.addEventListener('getaddress-autocomplete-address-selected', function(e){
document.getElementById('formatted_address_0').value = e.address.formatted_address[0];
document.getElementById('formatted_address_1').value = e.address.formatted_address[1];
document.getElementById('formatted_address_2').value = e.address.formatted_address[2];
document.getElementById('town_or_city').value = e.address.formatted_address[3];
document.getElementById('county').value = e.address.formatted_address[4];
document.getElementById('postcode').value = e.address.postcode;
})
</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.
Transparent Pricing
FAQ
- A postcode search counts as 1 look-up.
- 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.
We cross reference Ordnance Survey's complete list of uk postcodes (code point open) with the latest property sales, council tax register, companies house data
and over twenty other data sources to create near complete address database.
Public sector information licensed under the Open Government Licence v3.0.
Public sector information licensed under the Open Government Licence v3.0.
You may cancel your subscription at anytime. After unsubscribing, your subscription will run until the end of the purchased term.
Priority support is available 24-hours a day and can give advice on your code issues. Basic support will only provide advice with API issues or responses from our servers.
Yes, addresses are public data.
All payment details are sent directly to Stripe. We never see any of this information.
Stripe has been audited by a PCI-certified auditor, and is certified to PCI Service Provider Level 1.
This is the most stringent level of certification available.
Annual subscriptions can be purchased by bank transfer, please use the 'Send Quote' button when purchasing.