Stratum
Start
API reference · version 0.1.0

UK EPC Energy Performance

EPC data for any address in England and Wales, with a MEES verdict and retrofit cost estimates.

Base address
https://api.stratumapis.com/v1/epc
Your key
The X-Stratum-Key header, with the key from your API page. Paid per call from your API balance, with no plan (add money on your API page).
Prices
  • A lookup (an address, a UPRN, a postcode’s certificates or its summary)5p (2p from 1,000 a month)
Every reply carries X-Stratum-Credit-Balance-Pence; a refusal or a source failure is never charged. Limits and prices.
OpenAPI
Download the OpenAPI file (JSON)

Endpoints

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

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

Parameters
  • postcoderequiredin path
  • line1in query · Filter by first address line (optional but recommended for multi-property postcodes)
  • currentAnnualRentin query · Current annual rent in GBP. With it, meesVerdict.paybackEstimate.paybackMonths is worked out assuming the rent rises 5% for each EPC band the upgrade moves. Without it, the upgrade cost is still given and paybackMonths is null.
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/epc/address/NW98SU"
Errors
  • 401 Missing or invalid API key
  • 404 No certificate found for that address
gethttps://api.stratumapis.com/v1/epc/uprn/{uprn}

Get EPC by UPRN (unique property reference number)

Parameters
  • uprnrequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/epc/uprn/:uprn"
Errors
  • 404 No certificate found for that UPRN
gethttps://api.stratumapis.com/v1/epc/postcode/{postcode}/all

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

Returns every EPC certificate registered at the given postcode (typical converted block has 5–25), each with its own MEES verdict, plus a postcode-level meesSummary aggregate intended for portfolio-overview UIs.

Parameters
  • postcoderequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/epc/postcode/:postcode/all"
gethttps://api.stratumapis.com/v1/epc/postcode/{postcode}/aggregate

Postcode-level band distribution (coming soon; answers 501 until then)

Parameters
  • postcoderequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/epc/postcode/:postcode/aggregate"
Errors
  • 403 Aggregate endpoint requires Pro tier