Any address in Great Britain. Full property profile. One UPRN.
Pass a UPRN: get back the full property record. Address, coordinates, property type, bedrooms, EPC rating, floor area, last sold price, and 40+ additional attributes across tiered enrichment. The same data that powers property portals, AVM engines, and mortgage decisioning tools.
Pay as you go: 100 tokens = £1. First top-up matched 100%.
One UPRN. Two enrichment tiers.
The retrieve endpoint scales with your use case. Start with the /address/ tier for verified address data and coordinates. Step up to /base/ for EPC, bedrooms, and sold prices.
curl "https://api.homedata.co.uk/property/100023336956/base/" \ -H "Authorization: Api-Key YOUR_API_KEY"
{
"uprn": 100023336956,
"full_address": "10 DOWNING STREET, LONDON, SW1A 2AA",
"postcode": "SW1A 2AA",
"latitude": 51.5034,
"longitude": -0.1276,
"property_type": "Terraced",
"bedrooms": 4,
"epc_floor_area": 312,
"current_energy_efficiency": 71,
"last_sold_price_gbp": null,
"last_sold_date": null
}
Run this on your own key.
100 tokens = £1 · Top up from £20 · First payment matched 100%.
Two enrichment tiers
Pay only for what you need. Scale your enrichment tier as your product grows.
Address + location
- ✓ Full verified address
- ✓ Address lines 1–3
- ✓ Building name + number
- ✓ Street, locality, town
- ✓ Postcode + outward code
- ✓ Latitude + longitude
- ✓ UPRN, UDPRN, USRN
Property characteristics
- ✓ Everything in address
- ✓ Property type (Detached, Semi, etc.)
- ✓ Bedrooms + bathrooms
- ✓ Floor area (m²): EPC + predicted
- ✓ EPC current + potential score
- ✓ Last sold date + price
- ✓ Inflation-adjusted sold price
Who uses UPRN lookup
The retrieve endpoint is the core enrichment call, the one that turns an address into property intelligence.
property portals & listing tools
Auto-populate listing fields from the UPRN. Get property type, bedrooms, floor area, and EPC in one call, no manual entry. Reduce listing creation time from 20 minutes to 20 seconds.
mortgage & lending decisioning
Pull property characteristics at application stage. Verify property type, floor area, and EPC against applicant declarations. Use sold price history for LTV calculation. Flag converted, commercial, or non-standard construction.
automated valuation models
Seed your AVM with verified property characteristics: bedrooms, floor area, type, construction age, EPC score. Combine with comparables and price trends from the same API. No manual data collection for your model inputs.
retrofit & energy platforms
Get floor area and EPC score in one call, useful inputs for scoping retrofit work or energy assessments.
What is a UPRN?
A UPRN (Unique Property Reference Number) is a persistent numeric identifier assigned to every addressable location in Great Britain by Ordnance Survey. There are 39 million UPRNs covering 29 million residential properties.
Unlike postcodes (which cover ~15 properties) or full address strings (which vary by source), a UPRN uniquely identifies a single property and persists through address changes, renaming, and splitting.
If you have an address and postcode, use our Address Lookup API to find the UPRN first. Send both address and postcode. A successful match costs 5 tokens and returns address fields, one UPRN and address_resolution. HTTP 422 no_match or multiple_matches is never charged.
Practical patterns
Common integration patterns, from address to full property record.
Address match → property enrichment
Submit an address and postcode from your backend, then use the matched UPRN for enrichment. HTTP 200 costs 5 tokens; 422 no_match or multiple_matches is never charged.
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" # 200: address-level retrieve body plus address_resolution; 5 tokens. # 422: reason no_match or multiple_matches; never charged. # Use the returned UPRN for further property data.
Postcode → all addresses → enrich selected
List all properties at a postcode, let the user pick, then enrich the selected one. Standard pattern for mortgage and conveyancing forms.
# Step 1: get all addresses at postcode (2 tokens)
curl "https://api.homedata.co.uk/address/postcode/SW1A2AA/" \
-H "Authorization: Api-Key YOUR_API_KEY"
# → {"postcode": "SW1A 2AA", "count": 7, "addresses": [...]}
# Step 2: user selects their address → retrieve UPRN
curl "https://api.homedata.co.uk/property/100023336956/base/" \
-H "Authorization: Api-Key YOUR_API_KEY"
Get your API key
Pay as you go: 100 tokens = £1, first top-up matched 100%. From signup to first property lookup in under 5 minutes.