Skip to main content
Free UK property data API Start free →
All widgets EPC · drop-in widget

Energy ratings,
in a card.

Current and potential EPC rating for any UK property, lifted from the MHCLG register. Drops into your site in two lines of HTML — every band, every score, brand-locked.

A–G

Bands, official colours

MHCLG

Live data

~3kb

gzipped JS

Live demo · Sample residential — full EPC certificate

Two lines.

Drop these into your page. Pass a UPRN, the widget fetches the certificate and renders the official A–G colours.

your-page.html html
<div data-homedata-epc
     data-uprn="100023336956"></div>

<script src="https://homedata.co.uk/js/homedata-epc.js"
        data-key="wt_your_public_key_here"
        defer></script>

1 · Create a key

From Public Keys, scoped to epc_checker and your domain.

2 · Pass a UPRN

From your address picker, your CRM, or any property record. The widget handles the rest.

3 · Ship

Renders in ~150ms. Empty state if no EPC is lodged — never a blank card.

Configuration

All attributes go on the <div>.

Attribute Required Notes
data-uprn Required 12-digit UPRN. EPC lookup needs the exact property identifier.
data-theme Optional light (default) or dark.
data-no-branding Optional · paid tier Hide the "Powered by Homedata" footer.

Programmatic API

HomedataEPC.render({
  container: '#epc-result',
  uprn: '100023336956',
  key: 'wt_your_public_key_here',
  theme: 'dark',
});

Pair it with the Address Widget

The cleanest UX is to capture the UPRN with the address autocomplete widget, then pass it to the EPC widget. One pasted form, two embed snippets, three calls — the customer never types a UPRN by hand.

Where the EPC widget belongs

EPC rating sits next to price on every property buyer's checklist. Surfacing it on the listing — with the official A–G colour palette — turns a regulatory data point into a recognisable trust signal.

Landlord portfolios

MEES requires non-domestic rented properties to hit E or better, with C by 2030 in the pipeline. Stack the EPC widget on every property in the portfolio dashboard to spot non-compliant units at a glance.

Estate agents and portals

UK buyers expect EPC on every listing — Rightmove and Zoopla normalised it. The widget renders it consistent with the printed certificate, with potential rating shown for energy-conscious buyers.

Mortgage brokers and green finance

Green mortgage products reward EPC C or better with lower rates. The widget lets brokers surface eligibility checks during the application flow without scraping the EPC register.

How EPC bands work

The score is a number out of 100; the band is derived from the score. The widget renders both, using the exact colours from the printed EPC certificate.

A

Score 92+ · Excellent

Band A

B

Score 81–91 · Very good

Band B

C

Score 69–80 · Good

Band C

D

Score 55–68 · Average

Band D

E

Score 39–54 · Below average

Band E

F

Score 21–38 · Poor

Band F

G

Score 1–20 · Very poor

Band G

Try the free EPC checker first

Want to look up a specific property without signing up? The free EPC checker runs the same lookup with a postcode + address form — useful for spot-checking before deciding which properties to onboard into a widget integration.

Pairs naturally with

Stack widgets on the listing — capture UPRN once via the address picker, fan it out to multiple widgets.

Frequently asked

What does the EPC widget show?

Current and potential energy efficiency band (A–G) rendered in the official EPC certificate colours, the numeric score out of 100 for each, certificate date, floor area in square metres, and construction age band. When a property has no lodged certificate, the widget shows a clear empty state with the construction age.

Where does the EPC data come from?

The MHCLG Energy Performance of Buildings Register, published as Open Government Licence data. Homedata indexes the full register for England and Wales — around 25 million domestic certificates — and refreshes nightly.

What if the property has no lodged EPC?

The widget renders a premium empty state explaining that no certificate is on file, and shows the construction age band if available. This is most common for properties that have not been sold or let since EPCs became mandatory (2008 domestic, 2013 non-domestic). The rendered card is never blank.

Is the widget compatible with MEES compliance workflows?

Yes. The Minimum Energy Efficiency Standard requires non-domestic rented properties to be rated E or better, with proposals to raise this to C by 2030. The band and score shown are exactly the values used by MEES enforcement.

Ship it today.

Free tier includes 100 calls/month. Paid plans start at £49/mo for 2,000.