Replacing getAddress.io? Free drop-in replacement →
GET /api/epc-checker/{uprn}/ Ratings A–G

Property-Level EPC Data in One API Call

Look up the Energy Performance Certificate for any residential property in England and Wales 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. No scraping.

Free tier: 100 requests/month. No credit card required.

UPRN in. EPC data out.

The UK EPC register covers 24 million certificates. Our API surfaces the most recent certificate for any property — 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.

1
Get your API key
Free account — no credit card needed.
2
Pass the UPRN
Every registered property in England and Wales has one.
3
Get rating + score + details
Current and potential ratings with numeric scores, floor area, and construction age.
Request
curl "https://api.homedata.co.uk/api/epc-checker/100023336956/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
Response 200 OK
{
  "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.

A
92–100
Most efficient
B
81–91
Very efficient
C
69–80
Good
D
55–68
Average
E
39–54
Below average
F
21–38
Poor
G
1–20
Very poor

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.

current_energy_efficiency

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.

potential_energy_efficiency

What the property could achieve with recommended improvements. Useful for retrofit planning, green mortgage eligibility checks, and showing buyers the improvement headroom.

last_epc_date

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.

epc_floor_area

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.

construction_age_band

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.

epc_id

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.

uprn → current_energy_efficiency → show band badge on listing

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

uprn → current_score → green mortgage eligible?

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

current_score vs potential_score → improvement opportunity

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

portfolio uprns → bulk epc pull → mees compliance report

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 calls, no auth needed)
curl -G "https://api.homedata.co.uk/api/address/find/" \
  --data-urlencode "q=10 Downing Street London"

# Step 2: get EPC using UPRN from step 1
curl "https://api.homedata.co.uk/api/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/api/epc-checker/{uprn}/",
        headers={"Authorization": f"Api-Key {api_key}"}
    )
    data = r.json()
    current = data.get("current_energy_efficiency", 0)
    potential = data.get("potential_energy_efficiency", 0)

    return {
        "eligible": current >= 69,        # EPC C or above
        "with_improvements": potential >= 69,
        "improvement_gap": max(0, 69 - current),
    }

Get your free API key

100 requests/month on the free tier. No credit card. From signup to first EPC lookup in under 5 minutes.