Property data API
for landlords.
EPC ratings, council tax, flood risk, and rental market data for every UK property. Audit your portfolio for the 2028 EPC C compliance deadline, assess acquisitions before you buy, and pull rental comparables — all in one API.
Free tier: 100 calls/month. No credit card required.
EPC C becomes the legal minimum for all new tenancies by 2028
Properties rated D or below will need upgrading before they can be legally re-let. Check the current EPC rating of every property in your portfolio — before it becomes a compliance emergency.
29M+
UK properties covered
~60%
of rentals rated C or below
7
risk types per property
1 call
for EPC + floor area
Portfolio EPC audit — before the 2028 deadline
Around 60% of private rented properties in England and Wales are currently rated D or below. The government's planned MEES uplift will require EPC C as the minimum for all tenancies by 2028. That means millions of landlords face retrofit costs — the question is which properties need it most and how much headroom they have.
The Homedata EPC endpoint returns the current rating, potential rating, numeric efficiency score, floor area, and construction age for any assessed property. Batch your portfolio by UPRN and you'll have a compliance risk map in minutes — not weeks of manual portal lookups.
Check current EPC band (A–G) and numeric score (1–100) for any property
Potential rating shows how far the property can improve with recommended measures
Construction age band flags the era most likely to need insulation upgrades (pre-1930s)
Lodgement date tells you how old the certificate is — flag EPCs expiring within 12 months
GET /api/epc-checker/{uprn}/
Free endpoint — no plan required. Returns instantly for any UPRN.
{
"uprn": "100023045721",
"address": "23 Maple Close, Leeds, LS8 3AE",
"current_energy_rating": "D",
"current_energy_efficiency": 58,
"potential_energy_rating": "B",
"potential_energy_efficiency": 84,
"total_floor_area": 92.0,
"construction_age_band": "1967-1975",
"lodgement_date": "2021-09-14",
"property_type": "House",
"tenure": "rental (private)",
/* Needs upgrading — currently D (58)
Potential B (84) with improvements
Certificate expires 2031 */
}
EPC band compliance status
What landlords use it for
From compliance audits to acquisition due diligence.
EPC compliance audit
Batch your portfolio UPRNs through the EPC endpoint. Flag every property below C, sort by current rating (worst first), and estimate retrofit priority. Know your exposure before 2028 — not after.
BTL acquisition due diligence
Before you exchange: EPC rating and potential improvement headroom, flood risk band, council tax band, construction age (pre-1930 = cavity wall insulation challenge), and full listing history — all in a single API pass per property.
Rental yield benchmarking
Pull rental listing events for comparable properties in the postcode — current asking rents, time to let, and re-let frequency. Cross-reference with sold prices to calculate gross yield on target acquisitions.
HMO due diligence
Property type, bedrooms, floor area, and construction age — key inputs for HMO licensing calculations and room sizing compliance. Council tax band confirms the council billing category before you commit to a purchase.
Flood & environmental risk
Flood risk, radon, noise, landfill proximity, and air quality for any UPRN. Critical for buildings insurance quotes, mortgage lender requirements, and disclosing known risks to tenants under the Renters (Reform) Act.
Portfolio management tools
Build your own landlord dashboard with real data underneath it. Property details, EPC status, compliance flags, and market comparables — all returned as clean JSON, ready to render in whatever front-end you're using.
Portfolio EPC audit in Python
Have a list of UPRNs? This script fetches the EPC rating for each one and flags everything below C. Takes about 3 minutes to write, runs in seconds for a portfolio of 100.
What you get back
- Current EPC band (A–G) and score
- Potential band after improvements
- Floor area and construction age
- Certificate expiry (lodgement date + 10 years)
Pricing
EPC endpoint is 1 call per UPRN. Starter (£49/month) = 2,000 properties/month. Free tier = first 100 properties free.
import requests
API_KEY = "your_api_key_here"
BASE = "https://api.homedata.co.uk"
# Your portfolio — replace with real UPRNs
portfolio = [
"100023045721",
"10093609154",
"200004120312",
]
needs_upgrade = []
for uprn in portfolio:
r = requests.get(
f"{BASE}/api/epc-checker/{uprn}/",
headers={"Authorization": f"Token {API_KEY}"}
)
epc = r.json()
rating = epc.get("current_energy_rating")
score = epc.get("current_energy_efficiency")
address = epc.get("address")
if rating in ("D", "E", "F", "G"):
needs_upgrade.append({
"uprn": uprn,
"address": address,
"rating": rating,
"score": score,
"potential": epc.get("potential_energy_rating"),
})
# Print compliance report
print(f"\n{len(needs_upgrade)} properties need upgrading:\n")
for prop in sorted(needs_upgrade, key=lambda x: x["score"]):
print(
f" {prop['rating']} ({prop['score']}) → {prop['potential']} {prop['address']}"
)
Landlord Package — endpoints included
Everything you need for compliance, due diligence, and portfolio management.
| Endpoint | What it returns | Calls | Plan |
|---|---|---|---|
| /api/epc-checker/{uprn}/ | EPC band, energy score, floor area, construction age, lodgement date | 1 | Free |
| /api/council_tax_band/ | Council tax band A–H for any postcode | 1 | Free |
| /api/v1/properties/{uprn}/ | Bedrooms, property type, tenure, floor area | 1 | Free |
| /api/v1/listing_events/ | Full listing trail — rental asking prices, status, days to let | 1 | Free |
| /api/v1/property_sales/ | Comparable sold prices by UPRN or postcode | 1 | Free |
| /api/risks/flood_risk/?uprn= | River, surface water, coastal and groundwater flood risk bands | 1 | Starter |
| /api/risks/radon/?uprn= | Radon risk band for the property location | 1 | Starter |
| /api/risks/noise/?uprn= | Road, rail, and aircraft noise levels | 1 | Starter |
| /api/v1/address/find/ | Address autocomplete → UPRN (if you have addresses, not UPRNs) | 2 | Free |
| /api/v1/price_trends/ | Median sale prices and price growth by postcode/district | 1 | Starter |
Your first API call
Get the EPC rating for any property in 30 seconds. You'll need a free API key — sign up here (no credit card required).
curl -H "Authorization: Token YOUR_KEY" \ "https://api.homedata.co.uk/api/epc-checker/100023045721/"
import requests r = requests.get( "https://api.homedata.co.uk" "/api/epc-checker/100023045721/", headers={"Authorization": "Token YOUR_KEY"} ) print(r.json()["current_energy_rating"])
const r = await fetch( `https://api.homedata.co.uk /api/epc-checker/100023045721/`, { headers: { 'Authorization': 'Token YOUR_KEY' }} ) const { current_energy_rating } = await r.json()
Pricing for landlords
Start free. Upgrade if your portfolio needs more calls.
Free
£0/mo
- ✓ 100 API calls/month
- ✓ EPC, council tax, property data
- ✓ Listing events & sold prices
- ✓ Address lookup
- ✗ Environmental risk data
Starter
£49/mo
- ✓ 2,000 API calls/month
- ✓ Everything in Free
- ✓ Flood, radon, noise risk
- ✓ Price trends by postcode
- ✓ IMD deprivation data
Growth
£149/mo
- ✓ 10,000 API calls/month
- ✓ Everything in Starter
- ✓ Comparable sold prices
- ✓ Live rental listings
- ✓ Schools nearby data
Common questions
- What is the EPC C compliance deadline for landlords?
- The UK government is legislating that all private rental properties must achieve a minimum EPC rating of C before they can be let. The current target is 2028 for new and renewed tenancies, with all existing tenancies to follow. Properties rated D or below will need energy efficiency improvements — loft insulation, cavity wall insulation, double glazing, or heat pump installation — before landlords can legally re-let them. Note: the exact dates are subject to final legislation. Always check the latest MEES guidance from the government.
- What if my property has no EPC on record?
- Not all properties have a lodged EPC — particularly those that have never been sold or rented since 2008 (when EPC became mandatory for most transactions). The Homedata EPC endpoint will return a 404 if no certificate exists for the UPRN. You'll need a qualified energy assessor to carry out a new assessment. The endpoint also returns the lodgement date so you can flag certificates that are approaching expiry (EPCs are valid for 10 years).
- Can I look up flood risk for a property before buying?
- Yes. The /api/risks/flood_risk/?uprn= endpoint returns river, surface water, coastal, and groundwater flood risk bands for any UPRN. Available on Starter plan (£49/month). This is important for mortgage lenders (some will require flood risk checks) and for assessing buildings insurance costs.
- Does the API work for HMO properties?
- Yes. The property characteristics endpoint returns property type, number of bedrooms, and floor area — all key inputs for HMO licensing calculations. Council tax band data helps confirm the council billing category. EPC is also relevant for HMOs: each individual unit in a converted property may need its own certificate.
- Can I use this as a non-developer landlord?
- This is a developer API — it returns JSON data rather than a polished interface. If you want to use it without writing code, the easiest approach is to hire a developer to build a simple CSV-to-compliance-report script using our API. On Starter, a single developer could audit your entire portfolio in an afternoon for under £50 in API costs.