Energy EPC
GET /v1/energy/epc/{uprn}Every Energy Performance Certificate lodged against a UPRN, newest first, with current and potential ratings, floor area, construction age, heating and a retrofit gap per certificate. Free.
Same call over MCP
EPC certificates for a propertyepc_certificatesAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Reference
What GET /v1/energy/epc/{uprn} returns
The certificate history, not just the latest certificate. A property re-assessed after work has two certificates, and the difference between them is the evidence the work happened; a property let repeatedly has a run of them. Each carries the current and potential efficiency scores and bands, CO2, heating fuel and system, the total floor area, the construction age band and a retrofit_gap: the headroom between what the property scores and what its own certificate says it could.
The floor area is the field the rest of the platform leans on hardest. It turns a price into a price per square metre and it is what the valuation model needs before it will produce a number.
The full description, as the assistant reads it
Returns the HISTORY, not just the latest: a property re-assessed after work has two certificates, and the difference between them is the evidence the work happened.
Each carries a retrofit_gap, or null where it cannot be computed. Null means unknown, NOT zero — a zero gap means the property is already at its potential, which is a different claim.
No certificate is a real answer, not a failure: EPCs are lodged on sale or let, so a long-held property may never have had one.
UK only.
Reference
When to use it, and when not to
Use it for the energy position of one property: the band a landlord must meet, the work a buyer inherits, the age and construction a surveyor wants before the visit. For an area's band mix and heating split use energy_profile; for a ranked list of properties with the most headroom use retrofit_candidates. property_summary carries the latest band alongside the rest of the headline attributes if one figure is enough.
Inputs
Before you call it
A UPRN, as an integer. Resolve the address with address_autocomplete and address_resolve first.
- uprn
- A UPRN is the Unique Property Reference Number every UK address carries. Narrow the address with address_autocomplete, which is free, then address_resolve returns the UPRN for 8 credits. property_summary and address_by_postcode return UPRNs too.
Request
Calling GET /v1/energy/epc/{uprn}
curl "https://api.marketcode.ai/v1/energy/epc/200003443835" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| uprn | Path | integer | Yes | Property UPRN |
Response
What GET /v1/energy/epc/{uprn} returns for a real request
curl "https://api.marketcode.ai/v1/energy/epc/200003443835" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"{
"uprn": "200003443835",
"certificates": [],
"count": 0,
"note": "No certificate found for this UPRN. EPCs are lodged on sale or let, so a long-held property may never have had one.",
"credits_charged": 0
}A real response, captured from production and trimmed: arrays to three items, long strings shortened, volatile keys dropped.
Response
Response fields
| Field | Type | Example |
|---|---|---|
| uprn | string | 200003443835 |
| certificates | array | |
| count | integer | 0 |
| note | string | No certificate found for this UPRN. EPCs are lod |
| credits_charged | integer | 0 |
Fields observed in the example response above; a field the example did not exercise is not listed.
Reference
Things that catch people out
- No certificate is a real answer. Certificates are lodged when a property is built, sold or let, so a long-held owner-occupied house may never have had one. The response says so; it is not a failure.
- A null retrofit gap means unknown, not zero. A zero gap means the property is already at its potential, which is a different claim, and the two are kept apart.
- Certificates expire after ten years and can be wrong. An assessor's estimate of floor area from a quick visit is the figure the register holds; where MarketCode has measured building geometry it says which source the area came from.
- Bands F and G matter to landlords. Under the minimum energy efficiency standard they cannot legally be let without a registered exemption. The site dossier raises a signal for exactly this.
Price and licence
What it costs, and where the data comes from
Energy EPC is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- Ministry of Housing, Communities and Local Government
Energy Performance Certificates (domestic and non-domestic)
MHCLG's EPC open data terms · England and Wales
Related
Endpoints used with Energy EPC
- Energy profile of an areaFree
energy_profileEnergy composition of an area: EPC band mix, mains gas / electric / oil split, heat-pump penetration.Pairs with this - Retrofit candidates in an area6 credits
retrofit_candidatesProperties in an area with the most improvement headroom, ranked by potential efficiency. Defaults to the sub-standard bands E, F and G.Pairs with this - Property summary4 credits
property_summaryOne-call summary of a property: what it is, what building it belongs to,Pairs with this - Full valuation with back-seriesFree
valuation_fullFull valuation block for a property: the value and its range, a monthlyPairs with this - Resolve an address to a UPRN8 credits
address_resolveResolve free-text address to canonical record (UPRN for UK).Same product - Comparable properties6 credits
property_compsComparable properties in the same building or block, with missingSame product
Glossary
Terms used here
- Floor area: The internal area of a property in square metres, taken from its energy certificate or measured from building geometry; the input the valuation model cannot do without.
- EPC rating: The A to G energy efficiency band on an Energy Performance Certificate, lodged when a property is built, sold or let; MarketCode returns the full history of certificates, not just the latest.
- Retrofit gap: The difference between a property's current EPC score and the potential score its certificate says the recommended work would reach.
FAQ
Questions about Energy EPC
How much does `epc_certificates` cost?
+
Energy EPC is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Do I need to resolve the address first?
+
Yes. epc_certificates takes a UPRN, not an address. Start with address_autocomplete (free) to narrow the address, then address_resolve (8 credits) to get the UPRN. An assistant with the MarketCode skills installed does both steps on its own.
How do I authenticate?
+
Send your API key as a Bearer token in the Authorization header. Keys are created in the API & MCP Hub, shown once and revocable. Every response carries the credits charged and your remaining balance.
Is there an MCP version?
+
Yes. The epc_certificates tool on the MarketCode MCP server is the same call at the same price, signed in with OAuth rather than a key, so Claude, ChatGPT, Codex and Cursor can run it in a conversation.
Where does the data come from?
+
Read from Ministry of Housing, Communities and Local Government EPC register. Coverage is England and Wales.
Does `epc_certificates` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
Why the whole history rather than the latest certificate?
+
Because the history is evidence. Two certificates with the second a band higher show that work was done and roughly when; a run of certificates every few years shows a let property. The latest alone cannot tell you either.
Is the floor area on the certificate reliable?
+
It is the assessor's total floor area and it is what the register holds. It is usually within a few square metres; it is occasionally wrong. Where measured building geometry exists the property record says which source the platform used for its own calculations.
What does the retrofit gap tell an investor?
+
How far the property could move up the scale with the work its certificate recommends. A D that could be a B carries more upside, and more MEES risk avoided, than a C that could be a C.
Try Energy EPC on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.