Any UK Address. 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 at three enrichment levels. The same data that powers property portals, AVM engines, and mortgage decisioning tools.
Free tier: 100 requests/month. No credit card required.
One UPRN. Three enrichment levels.
The retrieve endpoint scales with your use case. Start with level=address for verified address data and coordinates. Step up to level=property for EPC, bedrooms, and sold prices. Use level=full for the complete 40+ field record including risk data, predicted price, and construction details.
curl "https://api.homedata.co.uk/api/address/retrieve/100023336956/?level=property" \ -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": null,
"level": "property"
}
Three enrichment levels
Pay only for what you need. Scale your enrichment level 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
Full intelligence
- ✓ Everything in property
- ✓ Construction age band
- ✓ Predicted current value
- ✓ Roof shape + material
- ✓ Has solar panels / garden / parking
- ✓ Building height + OS footprint area
- ✓ EPC renovation costs (min/max)
- ✓ Extensions, fireplaces, basement
- ✓ Land area m² + estimated volume
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, no scraping. 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 construction age, floor area, EPC score, and roof details in one call. The level=full response includes solar panel flag, building height, and OS footprint area — everything needed to scope retrofit work or solar assessment without a site visit.
What is a UPRN?
A UPRN (Unique Property Reference Number) is a persistent numeric identifier assigned to every addressable location in the UK 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 calls (no auth needed for the public endpoint) 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 calls, no auth needed)
curl -G "https://api.homedata.co.uk/api/address/find/" \
--data-urlencode "q=10 Downing Street London"
# → {"suggestions": [{"uprn": 100023336956, "address": "10 DOWNING STREET..."}]}
# Step 2: enrich (API key required)
curl "https://api.homedata.co.uk/api/address/retrieve/100023336956/?level=property" \
-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 (free), let the user pick, then enrich the selected one. Standard pattern for mortgage and conveyancing forms.
# Step 1: get all addresses at postcode (2 calls, no auth needed)
curl "https://api.homedata.co.uk/api/address/postcode/SW1A2AA/"
# → {"postcode": "SW1A 2AA", "count": 7, "addresses": [...]}
# Step 2: user selects their address → retrieve UPRN
curl "https://api.homedata.co.uk/api/address/retrieve/100023336956/?level=full" \
-H "Authorization: Api-Key YOUR_API_KEY"
Get your free API key
100 requests/month on the free tier. No credit card. From signup to first property lookup in under 5 minutes.