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
}
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 a postcode or an address string, use our Address Lookup API to find the UPRN first. It costs 2 tokens and returns UPRNs in the suggestion list.
Practical patterns
Common integration patterns, from address to full property record.
Address autocomplete → property enrichment
The complete address-to-data flow. Find → get UPRN → retrieve. Works in a form typeahead on the front-end, or batch enrichment in a pipeline.
# Step 1: autocomplete (2 tokens)
curl -G "https://api.homedata.co.uk/address/find/" \
--data-urlencode "q=10 Downing Street London" \
-H "Authorization: Api-Key YOUR_API_KEY"
# → {"suggestions": [{"uprn": 100023336956, "address": "10 DOWNING STREET..."}]}
# Step 2: enrich (API key required)
curl "https://api.homedata.co.uk/property/100023336956/base/" \
-H "Authorization: Api-Key YOUR_API_KEY"
# → {"bedrooms": 4, "epc_floor_area": 312, "current_energy_efficiency": 71, ...}
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.