Address lookup API
UK address lookup API.
Postcode lookup, an address finder for your forms and address matching for lists. 36.6 million addresses across Great Britain, and every result comes with its UPRN.
Searching is free · postcode lookup 2 tokens · address match 5 tokens, only on a match · 100 tokens = £1
Three ways to look up an address
Pick the one your form needs.
All three return the same thing at the end: a clean address and the property’s UPRN, the permanent ID for that home.
Postcode lookup
2 tokensSend a postcode, get every address at it with its UPRN. The list behind a “find my address” dropdown.
Postcode referenceAddress finder
1 token a pickSearch-as-you-type on your own form, from one script tag. Typing is free; you pay when someone picks an address.
Widget setupAddress match
5 tokens on a matchSend an address and postcode, get the one property it is. For cleaning lists and checking what a user typed. No match, no charge.
Match referenceRun this on your own key.
100 tokens = £1 · Top up from £20 · First payment matched 100%.
A UPRN on every result
Look it up once. Use it everywhere.
A postcode lookup or address match hands back the UPRN with the address. Store it, and every other Homedata call for that home takes it directly: no second round of address matching.
A match that finds nothing, or more than one home, returns HTTP 422 and is never charged.
curl "https://api.homedata.co.uk/address/postcode/SW1A2AA/" \ -H "Authorization: Api-Key YOUR_API_KEY"
curl --get "https://api.homedata.co.uk/address/match/" \ --data-urlencode "address=10 Downing Street" \ --data-urlencode "postcode=SW1A 2AA" \ -H "Authorization: Api-Key YOUR_API_KEY"
{
"results": [
{
"uprn": 100023336956,
"address": "10 Downing Street, London",
"postcode": "SW1A 2AA"
}
]
}
Response trimmed to the address fields.
Then, with the UPRN
How much does the address lookup API cost?
Pay as you go, 100 tokens = £1. A postcode lookup is 2 tokens, an address picked in the finder widget is 1 token (typing is free) and an address match is 5 tokens, charged only when it matches. No subscription.
Does it cover the whole UK?
Great Britain: England, Scotland and Wales, 36.6 million addresses. Northern Ireland uses a separate register and is not included.
What is a UPRN?
The Unique Property Reference Number, an ID of up to 12 digits given to every addressable place in Great Britain. It never changes, so it is the safest key to store. More on UPRNs →
Can I do a postcode lookup?
Yes. Send a postcode and get every address at it, each with its UPRN, ready for a “pick your address” dropdown. 2 tokens a lookup.
What happens if the address does not match?
HTTP 422 has reason no_match or multiple_matches. Neither is charged. Correct the submitted address or add missing flat or building details before retrying.
What’s the difference between address match and property retrieve?
Address match requires an address and postcode and matches them to one property. HTTP 200 returns the address-level retrieve body plus address_resolution for 5 tokens. HTTP 422 has reason no_match or multiple_matches and is never charged. Property retrieve uses that identifier to return data for one property. The address bundle returns address fields; base, core and complete bundles progressively add property, listing, sale, risk and comparable data.
Start with a postcode.
Postcode lookup 2 tokens. Address match 5 tokens, charged only on a match. 100 tokens = £1.