Skip to main content
29M UK properties, one API call. Get an API key →

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

Building it in? Get an API key →

Run 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.

Full endpoint reference

curl "https://api.homedata.co.uk/address/postcode/SW1A2AA/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

Response trimmed to the address fields.

Questions

About address lookup

Full answers in the API & data FAQ →

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.

29MUK properties, by UPRN
36.6Maddresses indexed
26 yrsof listing events, since 2000
23MEPC certificates on file
7licensed and official sources
Live status →

Start with a postcode.

Postcode lookup 2 tokens. Address match 5 tokens, charged only on a match. 100 tokens = £1.