UK EPC Energy Performance

API reference

Authentication

All requests require an X-Stratum-Key header. Get a key by subscribing to a plan.

Base URL

https://api.stratumapis.com/v1/epc

Endpoints

gethttps://api.stratumapis.com/v1/epc/v1/epc/address/{postcode}

Get the most recent EPC certificate for an address by postcode (latest match)

Parameters

postcoderequiredin path
line1in queryFilter by first address line (optional but recommended for multi-property postcodes)
currentAnnualRentin queryCurrent annual rent in GBP. When provided, the response's `meesVerdict.paybackEstimate.paybackMonths` is populated using 5% rent uplift per EPC band moved (placeholder until HomeLet rental-index ingest lands). Without it, upgrade cost is still computed but `paybackMonths` is null.

Example

curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/epc/v1/epc/address/:postcode

gethttps://api.stratumapis.com/v1/epc/v1/epc/uprn/{uprn}

Get EPC by UPRN (unique property reference number)

Parameters

Example

curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/epc/v1/epc/uprn/:uprn

gethttps://api.stratumapis.com/v1/epc/v1/epc/postcode/{postcode}/all

All EPC certificates at a postcode, each with its own MEES verdict

Parameters

Example

curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/epc/v1/epc/postcode/:postcode/all

gethttps://api.stratumapis.com/v1/epc/v1/epc/postcode/{postcode}/aggregate

Postcode-level band distribution (Pro tier)

Parameters

Example

curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/epc/v1/epc/postcode/:postcode/aggregate