Skip to main content

​
EPC certificates

The EPC endpoints return Energy Performance Certificate data for UK properties. Data is sourced from the HMG EPC register and matched to live listings via UPRN and PostGIS spatial joins. Required scope: epc:read Cost: 1 request per call Available on: Starter, Professional, Business

​
Get EPCs for a postcode

GET /api/v1/epc/postcode/{postcode}
Returns up to 100 EPC records for properties in the given postcode, ordered by EPC date desc.

​
Request

curl https://api.propaideals.co.uk/api/v1/epc/postcode/M1%201AA?limit=10 \
  -H "Authorization: Bearer paid_..."

import requests

res = requests.get(
    "https://api.propaideals.co.uk/api/v1/epc/postcode/M1 1AA",
    params={"limit": 10},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
records = res.json()["data"]["records"]

​
Query parameters

ParamTypeDefaultMaxDescription
limitinteger20100Max records to return

​
Response

{
  "data": {
    "count": 10,
    "records": [
      {
        "property_id": "5fa1b2c3-d4e5-6f78-9012-3456789abcde",
        "energy_rating": "C",
        "epc_score": 71,
        "epc_url": "https://find-energy-certificate.service.gov.uk/...",
        "epc_lmk_key": "abc123def456...",
        "epc_date": "2024-08-15",
        "construction_age_band": "1976-1982",
        "sqft_estimated": false,
        "uprn": 100012345678,
        "address": "12 Example Road, Manchester",
        "postcode": "M1 1AA"
      }
    ]
  }
}

​
Get EPC by UPRN

GET /api/v1/epc/uprn/{uprn}
Direct lookup by Unique Property Reference Number — the most reliable identifier for a UK property.

​
Request

curl https://api.propaideals.co.uk/api/v1/epc/uprn/100012345678 \
  -H "Authorization: Bearer paid_..."
Returns the same EpcRecord shape as above, or 404 if no EPC matches that UPRN.

​
Get EPC by property ID

GET /api/v1/epc/property/{property_id}
Look up the EPC linked to a specific Prop AI Deals property UUID (returned from the properties endpoint). 
curl https://api.propaideals.co.uk/api/v1/epc/property/5fa1b2c3-d4e5-6f78-9012-3456789abcde \
  -H "Authorization: Bearer paid_..."

​
Field reference

FieldTypeDescription
property_idUUIDInternal Prop AI Deals property identifier
energy_ratingstringEPC band: A (best) – G (worst)
epc_scoreintegerEPC numerical score 1–100
epc_urlstringDirect link to the official HMG certificate PDF
epc_lmk_keystringLMK certificate key (use to query MHCLG datasets directly)
epc_dateISO dateDate the certificate was issued
construction_age_bandstringEra the property was built (e.g. 1976-1982)
sqft_estimatedbooleantrue if floor_area_sqft was derived from the EPC certificate
uprnintegerUnique Property Reference Number (12-digit)
addressstringFull property address
postcodestringPostcode

​
Use cases

  • Mortgage origination: Fetch EPC for a property before underwriting (lenders increasingly require minimum EPC C from 2030)
  • Refurb planning: Identify F/G rated properties in a postcode for retrofit business
  • Compliance: Landlords need EPC C+ to let from 2028 — bulk-check a portfolio
  • Investment scoring: EPC band correlates with future MEES compliance cost
  • UPRN lookup — Resolve a UPRN to property metadata
  • Properties — Search live listings (returns the property UUIDs you’d pass here)