Property-Level EPC Data in One API Call
Look up the Energy Performance Certificate for a residential property in England and Wales where a certificate has been lodged, by UPRN. Pass a property identifier: get back the current rating, potential rating, energy efficiency score, floor area, and construction age band. No manual register lookups.
Pay as you go: 100 tokens = £1. First top-up matched 100%.
UPRN in. EPC data out.
The UK EPC register covers 24 million certificates. Our API surfaces the most recent certificate for a property where one has been lodged (current rating, potential rating, numeric score, floor area, and age band) in a single authenticated call.
EPC data is increasingly central to mortgage decisions, property listings, retrofit planning, and ESG reporting. Stop directing users to the government register, serve it from your own API.
curl "https://api.homedata.co.uk/epc-checker/100023336956/" \ -H "Authorization: Api-Key YOUR_API_KEY"
{
"uprn": 100023336956,
"current_energy_efficiency": 67,
"potential_energy_efficiency": 82,
"last_epc_date": "2022-04-14",
"epc_floor_area": 87,
"construction_age_band": "1967-1975",
"epc_id": "1813679032512022041400001"
}
EPC ratings explained
Properties in England and Wales are rated A to G on energy efficiency. The API returns a numeric score (1–100): use the score for precise comparisons and sorting. Here's how that maps to the familiar A–G letter bands.
Scores are numeric (1–100). Higher = more efficient. current_energy_efficiency reflects the property today; potential_energy_efficiency reflects achievable improvements.
Response fields
Every field in the EPC response, what it means and how to use it.
Numeric score (1–100) for the property's current energy performance. Maps to an EPC band: 69–80 = C, 55–68 = D, etc. Use this for sorting and filtering: more precise than the letter band.
What the property could achieve with recommended improvements. Useful for retrofit planning, green mortgage eligibility checks, and showing buyers the improvement headroom.
ISO 8601 date of the most recent EPC lodgement. EPCs are valid for 10 years: use this to flag stale certificates that may not reflect recent renovations or current energy prices.
Total habitable floor area in m² as recorded on the EPC. More reliable than listing descriptions: assessors measure it on-site. Use for price-per-sqm calculations and comparison searches.
The decade or period in which the property was built (e.g. "1967-1975", "2007-2011"). Correlates with cavity wall insulation eligibility, heating system type, and typical energy efficiency profile.
The EPC certificate reference number from the MHCLG register. Use to link back to the full government certificate PDF or cross-reference with other EPC data sources.
Who uses EPC data
EPC rating is one of the most-queried property data points in the UK: legally required on listings, critical for mortgages, and central to retrofit policy.
🏠 Property portals
EPC rating is a legal requirement on property listings. Show the band on listing cards and full pages, auto-populate from the register rather than relying on agents to upload certificates manually.
🏦 Mortgage & lending
Green mortgage products require EPC C or above. Automate eligibility checks at the point of application: pull the certificate by UPRN rather than asking applicants to upload a PDF. Flag upgrades needed for better rates.
⚡ Retrofit & energy platforms
Show homeowners the gap between current and potential efficiency. Combine with construction_age_band to recommend specific measures (cavity wall fill, loft insulation, heat pumps) and calculate ROI.
📊 Portfolio & ESG
Batch EPC lookups across a property portfolio for ESG reporting, Minimum Energy Efficiency Standards (MEES) compliance checking, and identifying below-EPC-C assets ahead of 2030 regulation deadlines.
Practical patterns
Common ways teams combine EPC data with other Homedata endpoints.
Address → EPC in two calls
Start with an address search to get the UPRN, then pull the EPC. No UPRN database required on your end.
# Step 1: find UPRN from address (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" # Step 2: get EPC using UPRN from step 1 curl "https://api.homedata.co.uk/epc-checker/100023336956/" \ -H "Authorization: Api-Key YOUR_API_KEY"
Green mortgage eligibility check
EPC C or above (score 69+) is the typical green mortgage threshold. Flag properties that qualify and those needing improvement.
import requests
def check_green_mortgage(uprn, api_key):
r = requests.get(
f"https://api.homedata.co.uk/epc-checker/{uprn}/",
headers={"Authorization": f"Api-Key {api_key}"}
)
data = r.json()
current = data.get("current_energy_efficiency")
potential = data.get("potential_energy_efficiency")
# Most UK properties have never been assessed, and those come back as
# null rather than as a score of 0 — an unassessed property has not
# earned the worst grade, it has no grade. Handle that first: treating
# null as 0 would silently rule out every unassessed property.
if current is None:
return {"eligible": None, "reason": "no EPC on record for this UPRN"}
return {
"eligible": current >= 69, # EPC C or above
"with_improvements": potential is not None and potential >= 69,
"improvement_gap": max(0, 69 - current),
}
Get your API key
Pay as you go — 100 tokens = £1, first top-up matched 100%. From signup to first EPC lookup in under 5 minutes.