Merge remote-tracking branch 'origin/main' into feature/e2e-runs

# Conflicts:
#	scripts/run_modelling_e2e.py

.claude/skills/epc-to-elmhurst-rdsap-inputs/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: epc-to-elmhurst-rdsap-inputs
+description: Convert an EPC certificate (by UPRN, certificate number, or local epc.json) into a markdown sheet of Elmhurst Energy RdSAP entry-tool inputs, page by page, so a human can key them in and compare Elmhurst's SAP score against this repo's engine. Use when verifying SAP-calculator accuracy against Elmhurst, reproducing a lodged cert in Elmhurst, or when the user mentions Elmhurst, RdSAP inputs, or checking the SAP score for a UPRN/certificate.
+---
+
+# EPC → Elmhurst RdSAP inputs
+
+Produces a markdown crib sheet for re-keying a real EPC certificate into
+Elmhurst Energy's RdSAP entry tool, so the operator can read off Elmhurst's
+SAP score and compare it to this engine's. The accuracy comparison is the
+whole point — the markdown leads with **our engine's SAP score** as the
+number to beat, and flags known divergences.
+
+This is prompt-driven: you read the cert's real values, look up each Elmhurst
+field in [reference/mapping.md](reference/mapping.md), and format the result.
+**Ground every number in the loaded `EpcPropertyData` and the engine's
+computed values — never guess a code or area.** Codes you can't find in the
+mapping reference must be looked up in the cited source file, not invented.
+
+## Workflow
+
+1. **Resolve the cert to an `EpcPropertyData`** (one of):
+   - **UPRN** — `scripts/fetch_real_life_epc_sample.py <uprn>` (fetches, saves to
+     `backend/epc_api/json_samples/real_life_examples/<schema>/uprn_<uprn>/epc.json`,
+     prints schema + lodged rating + engine output), or
+     `EpcClientService(auth_token=...).get_by_uprn(<uprn>)`.
+   - **Certificate number** — `EpcClientService.get_by_certificate_number(<cert>)`.
+   - **Local json** — `EpcPropertyDataMapper.from_api_response(json.load(...))`.
+
+   Token is in `backend/.env` (`OPEN_EPC_API_TOKEN`, else `EPC_AUTH_TOKEN`).
+   For a saved json, mock `httpx.get` to return `{"data": <json>}` (see the
+   fetch script), or call the mapper directly.
+
+2. **Compute the engine's view** so the sheet shows real numbers, not guesses:
+   ```python
+   from domain.sap10_calculator.calculator import Sap10Calculator
+   from domain.sap10_calculator.rdsap.cert_to_inputs import cert_to_inputs
+   inputs = cert_to_inputs(epc)          # window areas, U-values, fuel costs, cylinder
+   result = Sap10Calculator().calculate(epc)   # our SAP score + per-end-use kWh
+   ```
+   Pull window area from `inputs.heat_transmission.windows_w_per_k` + the
+   synthesised `epc.sap_windows`; U-values from `inputs.heat_transmission`;
+   fuel £/kWh from `inputs.*_fuel_cost_gbp_per_kwh`.
+
+3. **Write the markdown**, one section per Elmhurst page, in this order:
+   Property Description · Dimensions · Conservatory · Walls (incl. Party wall) ·
+   Roofs · Floors · Openings (Windows, Doors) · Ventilation & Lighting
+   (Ventilation, Mechanical Ventilation, Air Pressure Test, Lighting) ·
+   Space Heating (Main Heating 1, Main Heating 2, Community Heating, Meters) ·
+   Water Heating (Water Heating + cylinder, Community Hot Water, Solar Water
+   Heating, WWHRS, FGHRS) · New Technologies (PV, Wind, Hydro, Special Features).
+   For each field give the **Elmhurst label**, the **value to enter**, and where
+   useful the **EES dropdown path** and **SAP code**. Use the lookup tables and
+   gotchas in [reference/mapping.md](reference/mapping.md).
+
+4. **Flag what must NOT be mapped / must be cleared.** Elmhurst pages carry
+   defaults and (when re-keying into an existing assessment) stale values that
+   silently survive and corrupt the result — a phantom 1st extension, a
+   room-in-roof area, a party-wall length, leftover window rows. For every
+   element the cert does **not** have, say so explicitly with the Elmhurst
+   field to blank and the value to set (usually empty or 0). The automated
+   filler (`scripts/hyde/elmhurst_fill.py`) and a human both rely on this list
+   — an unflagged absent element defaults to "present" and skews SAP. See the
+   **Fields to clear** section in Output shape below.
+
+5. **Save** the file next to the cert json as `elmhurst_inputs.md`
+   (e.g. `.../real_life_examples/<schema>/uprn_<uprn>/elmhurst_inputs.md`).
+
+6. **Tell the operator**: key it into Elmhurst, then report the SAP score (and
+   heating cost £ if shown). If it differs from our engine's score, that's a
+   calculator finding — capture it.
+
+## Output shape
+
+Start the file with a header block:
+```
+# Elmhurst RdSAP inputs — UPRN <uprn> (cert <cert>, <schema>)
+**Lodged SAP:** <energy_rating_current>   **Our engine:** <result.sap_score>   ← compare Elmhurst against this
+**Known divergences:** <e.g. off-peak fuel-cost bug — see Meters>
+```
+Then the page sections as tables: `| Elmhurst field | Value | Notes (SAP code / EES path) |`.
+
+End the file with a **Fields to clear in Elmhurst (do NOT map)** section — one
+table listing every element the cert lacks but Elmhurst defaults or stale data
+would otherwise assert. This is the explicit "absent" set the filler and the
+operator clear:
+```
+## Fields to clear in Elmhurst (do NOT map)
+| Elmhurst field | Set to | Why absent |
+|---|---|---|
+| Property Description · 1st–4th Extension age band | (blank) | no extensions lodged |
+| Property Description · Room-in-Roof age band | (blank) | no room-in-roof building part |
+| Dimensions · Room(s) in Roof area | (blank) | ditto — leave empty, not 0 |
+| Dimensions · 1st–4th Ext. sub-tabs | 0 / blank | single building part |
+| Walls · Party wall | none/blank | `party_walls_w_per_k` = 0 |
+| Openings · surplus window rows | delete | window count from glazed-area band only |
+| Water Heating · cylinder | none | combi / instantaneous |
+| Conservatory / PV / Wind / Hydro / WWHRS / FGHRS | none | not lodged |
+```
+Give the **Elmhurst page · field**, the **cleared value** (prefer *blank* over
+0 where the field is "not applicable"; some validators reject 0), and the
+one-line reason. Absent ≠ zero everywhere — note which.
+
+## Critical gotchas (full detail in reference)
+
+- **Economy-7 / off-peak electricity** (`main_fuel_type`/`water_heating_fuel` 29):
+  Elmhurst meter type **must be Dual-rate / Economy 7 (7-hour)**, not Single.
+  Our engine has a **known over-rating bug** here — it prices 100% of off-peak
+  space heating + hot water at the 5.50p low rate instead of the SAP Table 12a
+  high/low split. Always flag this in the output for all-electric off-peak certs.
+- **WWHRS**: `sap_heating.instantaneous_wwhrs` is **bath/shower ROOM counts**
+  (ADR-0028), NOT a heat-recovery device → WWHRS = **No** unless a real unit is lodged.
+- **Party wall** code 1 = Solid (U=0, Elmhurst "Solid"), not "Unable to determine".
+- **Cylinder insulation** type 1 = Foam, 2 = Jacket.
+- **Water heating** 903 = Electric immersion off-peak → Elmhurst "Water Heater"
+  category, not "Boiler Circulator" (901 = from main system).
+- **Windows** are synthesised from `glazed_area` band × TFA — not real geometry.
+- **Age band — pick by construction YEAR, not the engine's band letter.** The
+  live RdSAP-10 tool bands differently from `mapping.md`'s older table: it
+  offers `…K 2007-2011`, **`L 2012-2022`**, **`M 2023 onwards`**. A 2020 build
+  is **L** even though the engine labels `construction_age_band` "M". Map the
+  year to Elmhurst's on-screen band; flag the letter divergence.
+
+## Canonical example
+
+UPRN **10002468137** (cert `0215-2818-7357-9703-2145`, RdSAP-Schema-17.1):
+all-electric high-heat-retention storage heaters on Economy 7, solid-brick
+uninsulated end-terrace. **Lodged SAP 55 vs engine 62** — the over-rating that
+motivated this skill. Use it to sanity-check output.

.claude/skills/epc-to-elmhurst-rdsap-inputs/reference/mapping.md

@@ -0,0 +1,242 @@
+# EpcPropertyData → Elmhurst RdSAP field mapping
+
+Complete code→value reference for the `epc-to-elmhurst-rdsap-inputs` skill.
+Every mapping cites its source in this repo. When a lodged code isn't listed
+here, look it up in the cited source file — do **not** guess.
+
+Field names below are the GOV.UK API / `EpcPropertyData` cert fields. Elmhurst
+labels are the entry-tool's on-screen labels.
+
+---
+
+## Property Description
+
+| Cert field | Code → value |
+|---|---|
+| `property_type` | 0=House, 1=Bungalow, 2=Flat, 3=Maisonette, 4=Park home |
+| `built_form` | 1=Detached, 2=Semi-detached, 3=End-terrace, 4=Mid-terrace, 5=Enclosed end-terrace, 6=Enclosed mid-terrace |
+| `construction_age_band` (England/Wales) | A=before 1900, B=1900–1929, C=1930–1949, D=1950–1966, E=1967–1975, F=1976–1982, G=1983–1990, H=1991–1995, I=1996–2002, J=2003–2006, K=2007 onwards |
+| Storeys | count of distinct floors in `sap_building_parts[].sap_floor_dimensions` |
+| Habitable / Heated rooms | `habitable_room_count` / `heated_room_count` |
+| Extensions / Rooms in roof | `extensions_count`; rooms-in-roof only if a room-in-roof building part is lodged |
+
+## Dimensions
+
+From `sap_building_parts[].sap_floor_dimensions[]`. Type = `measurement_type`
+(1 = Internal). One row per floor (`floor` 0 = ground/Lowest, 1 = 1st, …):
+- Floor Area = `total_floor_area`
+- Room Height = `room_height`
+- Heat Loss Perimeter = `heat_loss_perimeter`
+- Party Wall Length = `party_wall_length`
+- Heated Basement only if a basement floor is lodged.
+
+## Conservatory
+
+`conservatory_type` 1 = none → unchecked. `has_heated_separate_conservatory`.
+
+## Walls (Main + Party)
+
+**External / Main wall:**
+| Cert field | Mapping |
+|---|---|
+| `wall_construction` | 3 = Solid brick (look up others in source if not 3) |
+| Insulation | `wall_insulation_thickness` "NI" or `wall_insulation_type` NONE → **As Built**; genuine retrofit (External/Internal/Filled) → that type |
+| `wall_dry_lined` | Y/N → Dry-lining Yes/No |
+| `wall_thickness` (mm) | Wall Thickness; `wall_thickness_measured` Y → "Wall Thickness Unknown" unchecked |
+| `sap_alternative_wall` | enter as Alternative Wall 1 (`wall_area`, same code mapping) |
+
+**Party wall** — `party_wall_construction` → SAP10 wall code → U-value
+(source: `datatypes/epc/domain/mapper.py` `_API_PARTY_WALL_CONSTRUCTION_TO_SAP10`):
+| Code | Meaning | U | Elmhurst "Type" |
+|---|---|---|---|
+| 0 / None | no lodging | — | (cascade default) |
+| 1 | Solid masonry / timber / system | **0.0** | **Solid** |
+| 2 | Cavity masonry, unfilled | 0.5 | Cavity (unfilled) |
+| 3 | Cavity masonry, filled | 0.2 | Cavity (filled) |
+| 4 (house) / 5 (flat) | Unable to determine | 0.25 | Unable to determine |
+
+⚠️ Do **not** leave a code-1 party wall as "Unable to determine" — that wrongly
+adds ~0.25 × area of heat loss and depresses the Elmhurst score.
+
+## Roofs
+
+| Cert field | Mapping |
+|---|---|
+| Type | loft access → "PA Pitched (slates/tiles), access to loft"; flat / room-in-roof per description |
+| `roof_insulation_location` | 2 = loft (at joists) → Insulation "Joists" |
+| `roof_insulation_thickness` | string e.g. "200mm" → Insulation Thickness 200 mm (drives the default U) |
+
+## Floors
+
+| Cert field | Mapping |
+|---|---|
+| `floor_construction` | 1 = Solid; 4 = Solid (no-insulation variant); a "Suspended"-prefixed type only if genuinely suspended (timber vs not-timber matters for infiltration) |
+| Insulation | "no insulation (assumed)" / `floor_insulation` absent → **As built** |
+
+Source: `domain/sap10_calculator/worksheet/heat_transmission.py` floor logic.
+
+## Openings — Windows (RdSAP reduced-data, synthesised)
+
+RdSAP certs carry **no real window geometry**. The engine synthesises it
+(`datatypes/epc/domain/mapper.py` `_synthesise_reduced_field_windows`):
+```
+total_glazing_area = 0.148 × total_floor_area × band_multiplier   # _RDSAP20_GLAZING_RATIO = 0.148
+split 4-way across orientations (1,3,5,7) = N, E, S, W            # _RDSAP20_SYNTH_ORIENTATIONS
+each window: width = area/4, height = 1.0  (height=1 so width carries the area)
+```
+`glazed_area` band multiplier (`_RDSAP20_GLAZED_AREA_BAND_MULTIPLIER`):
+| Code | Band | × |
+|---|---|---|
+| 1 | Normal | 1.00 |
+| 2 | More than typical | 1.25 |
+| 3 | Less than typical | 0.81 |
+| 4 | Much more than typical | 1.51 |
+| 5 | Much less than typical | 0.62 |
+
+Per-window fields:
+- Glazing Type: from `multiple_glazing_type`; when no explicit install date is
+  lodged use **"Double with unknown install date"** (don't assert a date band).
+  ⚠️ RdSAP-17.x/18/19 inherit RdSAP-20.0.0 glazing coefficients — the code→date-band
+  translation across the 17.1 ↔ RdSAP-10 boundary is a known fidelity risk; report the
+  U-value Elmhurst assigns vs the engine's effective `windows_w_per_k ÷ total area`.
+- Frame Type: `pvc_window_frames` true → PVC
+- Glazing Gap: `glazing_gap` mm
+- Orientation: not lodged — spread evenly N/E/S/W (matches the engine)
+- Location: **External wall**
+- Draught Proofed: `percent_draughtproofed` (100 → checked)
+- U-value / g-value: leave Elmhurst defaults; note them for comparison.
+
+## Openings — Doors
+
+`door_count` (Total), `insulated_door_count` (Insulated), draughtproofed =
+`door_count` when `percent_draughtproofed` 100. Engine default uninsulated door
+U = 3.0 W/m²K, area 1.85 m² → `doors_w_per_k` ≈ count × 1.85 × 3.0.
+
+## Air permeability (CRITICAL — q50 is AP50, not AP4)
+
+A lodged "Air permeability X m³/h.m² (as tested)" is a **q50** result (Blower-Door,
+at 50 Pa). SAP/RdSAP infiltration line `(18) = AP50/20 + (8)` — Elmhurst's worksheet
+labels it **"Measured/design AP50"** and divides by 20 (worksheet lines 17/18).
+
+⚠️ **Do not confuse with AP4** (air permeability at 4 Pa, from a *Pulse* test),
+whose cascade is `(18) = 0.263 × AP4^0.924 + (8)` — a much larger number for the
+same value. Mapping a q50 onto the AP4 path massively over-counts infiltration
+(e.g. q50 4.5 → 1.0 ach vs the correct 4.5/20 = 0.225). The full-SAP mapper now
+routes the lodged air permeability to `SapVentilation.air_permeability_ap50_m3_h_m2`
+(the `/20` path); fixed in the uprn_10093116528 campaign (gov-API SAP 78→82, vs
+Elmhurst worksheet 81). In Elmhurst enter it via Air Pressure Test → **Blower Door**
+→ result (and a certificate number, which the validation requires).
+
+## Ventilation & Lighting
+
+- **Ventilation**: open chimneys = `open_fireplaces_count`; flues/passive
+  vents/flueless gas fires/extract fans = lodged counts (0 if not lodged);
+  Fixed space cooling = `has_fixed_air_conditioning`. Draught Lobby not in RdSAP
+  house reduced-data → leave default.
+- **Mechanical Ventilation**: `mechanical_ventilation` 0 = natural → unchecked.
+- **Air Pressure Test**: RdSAP certs → "Not available" (uses % draughtproofing).
+- **Lighting**: SAP-2012 certs lodge **outlets**, not bulbs —
+  Total bulbs = `fixed_lighting_outlets_count`,
+  low energy = `low_energy_fixed_lighting_outlets_count`. RdSAP-10's bulb
+  methodology differs slightly, but lighting is a minor energy term.
+
+## Space Heating
+
+**Main Heating** — `sap_heating.main_heating_details[]`:
+- `sap_main_heating_code` is the SAP code. e.g. **409 = High heat retention
+  storage heaters** (EES path: Electric → Electric → Storage → High heat retention).
+- `main_heating_control` is the controls SAP code. e.g. **2404 = Controls for
+  high heat retention storage heaters** (EES: Storage Radiator Systems → CSD).
+- `main_heating_fraction` → Percentage of Heat (1 = 100%).
+- `storage_heaters[]`: count + `high_heat_retention` flag → the heater list.
+- Only one main system → leave Main Heating 2 empty. PCDF refs 0 unless a PCDF
+  boiler/control is lodged. Heat Emitter / Flue / Pump Age are wet-system fields —
+  N/A once a storage-heater code is chosen.
+
+**Secondary** — e.g. "Portable electric heaters (assumed)" → Electric →
+Electric → Room Heaters → Panel/convector/radiant (SAP 691), standard-tariff
+electricity (fuel 30). `secondary_heating_fraction` default 0.1.
+
+**Community Heating**: None unless community-heating lodged.
+
+**Meters** — `sap_energy_source`:
+- `mains_gas` Y/N → "Mains gas supply available" checkbox.
+- Electricity meter type from the heating/HW **fuel code** (see below).
+- `meter_type`; smart-meter flags if lodged.
+
+### Fuel codes & Economy-7 (CRITICAL — known engine bug)
+
+Table 32 unit costs, p/kWh (`domain/sap10_calculator/tables/table_32.py`):
+| Code | Fuel | p/kWh |
+|---|---|---|
+| 30 | Electricity, standard tariff | 13.19 |
+| 31 | 7-hour tariff **low / off-peak** | 5.50 |
+| 32 | 7-hour tariff **high** | 15.29 |
+| 33 | 10-hour low | 7.50 |
+| 34 | 10-hour high | 14.68 |
+| 35 | 24-hour heating tariff | 6.61 |
+| 38 / 40 | 18-hour high / low | 13.67 / 7.41 |
+
+**`main_fuel_type` / `water_heating_fuel` 29 = off-peak (7-hour) electricity** →
+Elmhurst Electricity meter type = **Dual-rate / Economy 7 (7-hour)**, NOT Single.
+
+✅ **Economy-7 high/low split — FIXED (PR #1217).** The engine now applies the SAP
+**Table 12a Grid 1** (space) + **Table 13** (immersion DHW) high/low split rather
+than pricing 100% at the 5.50p low rate. Electric STORAGE heaters legitimately get
+a 0.00 SH high-rate fraction (100% low — spec value, not a bug); immersion HW takes
+the cylinder-volume/occupancy/single-dual Table 13 blend (applied in
+`cert_to_inputs._hot_water_fuel_cost_gbp_per_kwh` when volume + occupancy +
+single/dual are all resolved; absent any of them it still falls back to 100% low —
+a rarer edge). Verified: canonical UPRN 10002468137 engine 60.92 = Elmhurst 61 to
+the penny (its lodged 55 is the OLD SAP-2012 schema, not comparable); UPRN
+10022893721 engine 79 = lodged 79, Elmhurst (Dual meter) 81.
+
+⚠️ **When building in Elmhurst you MUST set the Economy-7 meter** (`main_fuel_type`
+/ `water_heating_fuel` 29 = off-peak 7-hour → Electricity meter type **Dual**, NOT
+Single). Elmhurst silently defaults to Single/Standard and prices at the 13.19p
+standard rate, collapsing the worksheet SAP ~13 points — which can masquerade as an
+engine "over-rating". The control is a hidden Meters sub-tab on the SpaceHeating
+page (`TabPanelMeters_RadioButtonListElectricityType`).
+
+## Water Heating
+
+| Cert field | Mapping |
+|---|---|
+| `water_heating_code` | 901 = From main heating system (Elmhurst "Boiler Circulator"); **903 = Electric immersion, off-peak → Elmhurst "Water Heater" category** (NOT Boiler Circulator) |
+| `water_heating_fuel` | as Fuel codes above (29 = off-peak) |
+| `has_hot_water_cylinder` | → "Hot Water Cylinder Present" |
+| `cylinder_size` | **code 2 = Normal / 110 L, code 3 = Medium / 160 L, code 4 = Large / 210 L** (RdSAP 10 §10.5 Table 28; source: `cert_to_inputs.py` `_CYLINDER_SIZE_CODE_TO_LITRES`). In Elmhurst pick the **litre value**, NOT the label — "Normal" = 110 L. |
+| `cylinder_insulation_type` | **1 = factory Foam, 2 = loose Jacket** (source: `cert_to_inputs.py` `_CYLINDER_INSULATION_TYPE_LOOSE_JACKET = 2`) |
+| `cylinder_insulation_thickness` | mm (38 mm ≈ factory foam; jackets 80 mm+) |
+| `immersion_heating_type` | **code 1 = DUAL, code 2 = SINGLE** (source: `cert_to_inputs.py` ~L5288, per RdSAP 10 §10.5 "assume dual on a dual/off-peak meter" + the API cohort). ⚠️ Do NOT read 1 as "single" — single vs dual flips the Table 13 high-rate fraction and can swing the SAP score several points (e.g. cert 10002468137: dual 0.131 → SAP 61, single 0.571 → SAP 57). Storage-heater / off-peak certs are almost always code 1 = dual. |
+
+- **Community Hot Water**: 0 unless lodged.
+- **Solar Water Heating**: `solar_water_heating` Y/N.
+- **Number of baths** (Elmhurst tab: **Water Heating → WWHRS sub-tab → "Total no. of Baths"**, NOT the main Water Heating sub-tab): the gov-API derives it from `sap_heating.instantaneous_wwhrs` ROOM counts — `number_baths = rooms_with_bath_and_or_shower + rooms_with_bath_and_mixer_shower`. ⚠️ Elmhurst defaults this to 0; set it to the derived count or the gov-API and Elmhurst hot-water demand diverge (e.g. cert 10002468137: 2 baths = +165 kWh HW ≈ +£11 ≈ +0.7 SAP). Keep WWHRS itself **No**.
+- **WWHRS**: ⚠️ `sap_heating.instantaneous_wwhrs` holds **bath/shower ROOM
+  counts** (ADR-0028: `rooms_with_bath_and_or_shower`, `rooms_with_mixer_shower_no_bath`,
+  `rooms_with_bath_and_mixer_shower`) — it is **NOT** a heat-recovery device.
+  Set WWHRS = **No / not present** unless a genuine WWHRS unit is lodged. A
+  phantom WWHRS recovers heat and wrongly raises the Elmhurst score.
+- **FGHRS**: `main_heating_details[].has_fghrs` Y/N (per main heating system).
+
+## New Technologies
+
+- **PV**: `sap_energy_source.photovoltaic_supply` — `none_or_no_details` → None.
+- **Wind**: `wind_turbines_count` 0 → not present (terrain type irrelevant then).
+- **Hydro**: 0 unless lodged.
+- **Special Features (Appendix Q)**: none unless lodged.
+- "Export capable meter" has no effect with no generation.
+
+---
+
+## Source files
+
+| Concern | File |
+|---|---|
+| API → EpcPropertyData mapper, party-wall & window synthesis | `datatypes/epc/domain/mapper.py` |
+| cert → calculator inputs, cylinder insulation, fuel costs | `domain/sap10_calculator/rdsap/cert_to_inputs.py` |
+| heat transmission (U-values, floors, party walls) | `domain/sap10_calculator/worksheet/heat_transmission.py` |
+| fuel unit costs | `domain/sap10_calculator/tables/table_32.py` |
+| EPC fetch by UPRN | `scripts/fetch_real_life_epc_sample.py` |
+| EPC client | `infrastructure/epc_client/epc_client_service.py` |

.claude/skills/expand-sap-accuracy-corpus/SKILL.md

@@ -0,0 +1,356 @@
+---
+name: expand-sap-accuracy-corpus
+description: Drive the per-UPRN SAP-accuracy corpus campaign. For each UPRN ensure the EPC-API→EpcPropertyData mapping exists (extend the mapper if the schema isn't covered), build the cert in Elmhurst (hyde Playwright automation), download its Input Summary + SAP Worksheets, reconcile our SAP calculator to within 0.5 of Elmhurst's accredited worksheet by fixing mapper gaps (not tuning), and pin a RealCertExpectation regression. Use when expanding SAP-calculator schema coverage/accuracy across many real certs, working the 100-UPRN worklist one at a time, validating the EPC mapper against Elmhurst, or when the user mentions the SAP accuracy corpus / Elmhurst worksheets / the UPRN campaign.
+---
+
+# Expand SAP accuracy corpus
+
+A campaign wrapper around **`validate-cert-sap-accuracy`**, run **one UPRN at a
+time** over [worklist.md](worklist.md). Why a UPRN at a time: we are rewriting /
+extending the mapper incrementally, and each pass should (a) widen EPC-schema
+coverage, (b) fix one real mapper gap, (c) leave the skills/tests sharper for the
+next UPRN.
+
+**Goal per UPRN:** our SAP calculator within **0.5 SAP** of Elmhurst's
+accredited worksheet, the agreed score pinned as a `RealCertExpectation`.
+
+The big picture: an old EPC → `EpcPropertyData` → our SAP calculator predicts the
+score the property would get unchanged. Elmhurst is the accredited ground truth;
+its Input Summary (parsed back to `EpcPropertyData`) exposes mapper holes, and its
+worksheet exposes calculator holes.
+
+## ⏩ Resume in a fresh context (autonomous run)
+
+If the user says "continue" / "next" / "keep going through the worklist", run this
+loop **continuously without asking between certs** — report only `eng X / elm Y`
+per cert and tick the worklist line as each is pinned. The build automation is
+fully working (see `scripts/hyde/elmhurst_lib.py` helpers + the `build_<uprn>.py`
+templates); most certs build unattended end-to-end.
+
+**State (2026-06-19):** pinned this campaign — SAP-17.1 cohort + RdSAP-17.1/18.0
+(older) plus: **16.1** `100021943298` (76/75), **19.1.0** `10096028301` (82/82),
+**16.3** `44012843` (79/78), **17.0** `10023444324` (80/80) + `10023444320`
+(81/82), **RdSAP-20.0.0** `10090844932` (78/77), **16.2** `100090182288` (69/71,
+semi house). Latest run (2026-06-19): **16.2** `100021985993` (74/72, end-terrace
+bungalow), **17.1** `10091568921` (82/80, full-SAP end-terrace house combi 17615)
++ `10093718424` (81/80, semi sibling), **RdSAP-18.0** `10022893721` (79/81, first
+NON-BOILER cert — electric storage heaters + immersion; storage-heater automation
+now SOLVED incl. the Economy-7 Dual-meter step, see banked findings; engine 79 =
+lodged, NO bug), **RdSAP-21.0.1** `10023443426` (76/79, native schema, combi house;
+engine 76 = lodged EXACTLY; Elmhurst +3 = omitted-secondary build gap). Next `[ ]`:
+`10093412452` (SAP-17.1), then `10090343335` (17.0) / `10093115480` (17.1) /
+`68151071` (RdSAP-17.0). Skip `100020933699` (user said skip), `[⛔]` (NOT
+MAPPABLE), `[⚠]` (flagged engine bugs: MVHR / heat-pump fuel-39).
+
+**Per-UPRN recipe** (all commands `DISPLAY=:99`, cwd `scripts/hyde`; run
+`bash scripts/hyde/start_viewer.sh` once; creds in `.elmhurst-creds.json`; shared
+assessment GUID `B44A0DB4-4C08-4241-B818-86F060172105`):
+1. `PYTHONPATH=/workspaces/model python scripts/fetch_real_life_epc_sample.py <uprn>`
+   then scope: dwelling_type/built_form, age band, walls/roof/floor descriptions,
+   heating `main_heating_index_number`/category/`has_hot_water_cylinder`, window
+   total area (`sum(sap_windows w*h)`), party_wall_length, lighting %, MEV/AP50.
+2. **Copy the closest `build_<uprn>.py` template** and adjust values:
+   - combi flat → `build_100021943298.py`; regular-boiler+cylinder flat →
+     `build_44012843.py`; full-SAP combi flat (MEV+AP50) → `build_10096028301.py`
+     / `build_10023444324.py` (+party wall) / `build_10023444320.py` (mid-floor);
+   - combi house → `build_10090844932.py` (end-terrace, party wall) /
+     `build_100090182288.py` (semi, no party wall).
+   Adjust: property type/built-form, band (`_pick` by year, e.g. "1950"/"2012"/
+   "2023"), two-floor dims + party wall, wall insulation, roof, floor, window m²,
+   doors, lighting, boiler PCDB ref + search query, MEV/AP50 if present.
+3. Run pages: `for p in property_description [flats] dimensions walls roofs floors
+   openings ventilation; do … build_<uprn>.py $p; done` (one Save&Close each,
+   ~1 min/page; flats only for Flat property type). Then a window-verify/fix
+   snippet (re-add the combined window if the grid shows 0.00), then
+   `build_<uprn>.py space_heating` and `water_heating`.
+4. Heating uses the `elmhurst_lib` helpers: `E.select_boiler(page, "<model>",
+   "<pcdb_id>")` (look up id/type in `domain/elmhurst/pcdb_gas_oil_boiler_codes.csv`;
+   the lodged `main_heating_index_number` IS the id); control
+   `E.set_heating_dialog(page, "…ButtonMainHeatingControls", "^Boilers",
+   "^Standard", "CBE Programmer, room thermostat and TRVs")` (=2106); water
+   `E.set_heating_dialog(page, "…ButtonWaterHeatingCode", "From Space Heating",
+   "From the primary heating system")`; combi → `E.clear_hot_water_cylinder(page)`.
+5. Download: edit `elmhurst_download.py` `SAMPLE_DIR` to the cert's
+   `<schema>/uprn_<uprn>` dir; first confirm Recommendations is clean (parse
+   `[id*=ContentPlaceHolder1] a` link text — Summary silently redirects to Address
+   until zero errors); `python scripts/hyde/elmhurst_download.py` (retry once; the
+   nav goes Address→Recommendations→Summary).
+6. `PYTHONPATH=/workspaces/model python scripts/compare_epc_paths.py <uprn>` →
+   read **"gov-API inputs → SAP"** (engine) and **"Elmhurst's OWN engine
+   (worksheet …)"** (Elmhurst ground truth). Target ≤0.5–1.
+7. **Pin** the engine value: add a `RealCertExpectation(schema, sample=uprn_<uprn>,
+   cert_num, sap_score=<engine>)` in `tests/.../test_real_cert_sap_accuracy.py`;
+   run `…::test_real_cert_sap_score`.
+8. Tick the worklist line `[x] … · eng X / elm Y (lodged Z) · PINNED …`. Next cert.
+
+See **Banked findings** below for the modal-dialog mechanics (all already encoded
+in the helpers). New schema not mappable → add a dedicated `from_*_schema_*`
+mapper first (per-schema convention) + guard with the RdSAP-21.0.1 corpus gauge.
+
+## The loop (one UPRN)
+
+1. **Pick** the first `[ ]` UPRN in [worklist.md](worklist.md).
+2. **Capture** — `PYTHONPATH=/workspaces/model python scripts/fetch_real_life_epc_sample.py <uprn>`
+   → `epc.json` + schema + engine SAP under `…/real_life_examples/<schema>/uprn_<uprn>/`.
+   - **`NOT MAPPABLE`** (schema uncovered, e.g. full SAP) → this *is* the coverage
+     work: **extend the mapper** for that schema (`EpcPropertyDataMapper` / per-cert
+     mapper — Khalim's domain). Mark `🔧 mapper-gap`, build it, re-run. Guard with
+     the RdSAP-21.0.1 corpus gauge (`test_sap_accuracy_corpus.py`).
+3. **Inputs** — run the **`epc-to-elmhurst-rdsap-inputs`** skill on the UPRN →
+   complete `elmhurst_inputs.md` (+ its **Fields to clear** section).
+4. **Build in Elmhurst** (`scripts/hyde/`, mechanics in `elmhurst_README.md`):
+   `bash scripts/hyde/start_viewer.sh` (noVNC on :99) → log in once
+   (`elmhurst_session.py login`) → **create a NEW assessment for this UPRN** →
+   fill from `elmhurst_inputs.md`: `elmhurst_fill.py` auto-fills the derivable
+   pages (incl. the boiler cascade) + the clears; key the 🔸 fields by hand. Then
+   `elmhurst_download.py` saves **`elmhurst_summary.pdf`** + **`elmhurst_worksheet.pdf`**
+   into the sample dir. ⚠ The filler hard-codes one assessment + one cert's values
+   today — see **Limitations**.
+5. **Compare** — `PYTHONPATH=/workspaces/model python scripts/compare_epc_paths.py <uprn>`
+   → deep-diffs gov-API vs Elmhurst-parsed `EpcPropertyData`, runs **both** through
+   the engine, and prints Elmhurst's own worksheet SAP. Read it: engine-on-Elmhurst-
+   inputs ≈ worksheet ⇒ calculator faithful; gov-API vs Elmhurst gap ⇒ input diffs.
+6. **Reconcile to ≤0.5** — triage every field diff (use the
+   `epc-to-elmhurst-rdsap-inputs` `reference/mapping.md` for code semantics):
+   - **Elmhurst data-entry error** → fix in Elmhurst, re-export, re-run step 5.
+   - **gov-API mapper gap** → the leverage point. Fix the mapper **generically**;
+     never tune to one cert. Cosmetic diffs (codes vs strings, empty lists) are noise.
+   - **Genuine ground-truth** → align both sides to the lodged data.
+7. **Pin** — add a `RealCertExpectation` to
+   `tests/domain/sap10_calculator/test_real_cert_sap_accuracy.py`; run it. If a
+   known engine bug still blocks, use `known_bug_xfail="…"` (strict xfail) — don't widen.
+8. **Bank** — fold what you learned into `mapping.md` / this skill / the tests so
+   the next UPRN is easier, and set the worklist status (see legend).
+
+## Worklist status legend
+`[ ]` todo · `[x]` pinned (≤0.5) · `🔧` mapper extended · `⚠` xfail (engine bug) ·
+`⛔` blocked. Annotate each done line: `— <schema> · eng <X> / elm <Y> · <note>`.
+
+## Elmhurst build playbook (READ THIS before driving the browser)
+Use **`scripts/hyde/elmhurst_lib.py`** — it encodes the auth + DOM gotchas below.
+Pattern: `with E.session() as (ctx,page): E.goto(...); E.set_text/set_select(...); E.save_close(page)`.
+
+- **Auth is a SESSION cookie** — Playwright's persistent context does NOT restore
+  it across process launches, so the old "log in once, reuse session" flow breaks.
+  Instead **log in fresh every run** (`E.session()` reads creds from `ELM_ACCESS`/
+  `ELM_PWD` or gitignored `scripts/hyde/.elmhurst-creds.json`). Assessment DATA
+  persists server-side via **Save & Close**, so you can build/verify ONE page per
+  run across separate processes. Start the viewer first: `bash scripts/hyde/start_viewer.sh`.
+- **Build page-by-page, Save & Close each** — overwrite the reused assessment's
+  prior-UPRN state (incl. property type House↔Flat, which reveals/hides fields).
+  After each `set_*`, the page AutoPostBacks — re-locate the next control.
+- **Sub-tabs hide fields** — Doors, Air Pressure Test, Lighting, FGHRS etc. are
+  Ajax tabs; their inputs exist in the DOM but are invisible until you
+  `E.click_tab(page, "TabContainer_TabPanel<X>Panel")`. Forgetting this → "element
+  not visible" timeouts AND missing-required-field validation errors.
+- **Window grid is the hard part.** (a) delete is a Yes/No MODAL
+  (`E.delete_first_window`); (b) it WON'T delete the last row; (c) **each Add wipes
+  the previously-added row** → multi-row entry doesn't stick. So enter **ONE
+  combined window**: `E.add_combined_window(page, total_glazed_area, orientation)`
+  then delete the prior rows. Use a standard band glazing ("Double post or during
+  2022" ≈ U1.4/g0.72) — the "...known data" option demands per-row Frame-Factor/
+  Data-Source/Location/Building-Part and fails validation. Trust the grid only
+  after Save & Close + reload (the live grid mis-shows older rows as 0.00).
+- **U-value-known overrides** (walls/roof/floor) don't toggle via automation →
+  accept the natural RdSAP age-band U-value; note the divergence for reconciliation.
+- **Recommendations page = validation gate.** It must show ZERO errors before the
+  summary/worksheet PDFs download. Usual culprits: insulated-door U-value, and the
+  air-pressure-test **certificate number** (required when method=Blower Door).
+- **Air permeability**: enter the lodged q50 via Air Pressure Test → Blower Door →
+  result. Elmhurst treats it as **AP50** and uses `(18)=AP50/20+(8)` (worksheet
+  lines 17/18). This drove the first campaign mapper fix — see Banked findings.
+
+## Banked findings (fold new ones in here as the corpus grows)
+- **MAPPER GAP — cylinder insulation thickness dropped (RdSAP-17.0+):** the mapper
+  carries `cylinder_size` + `cylinder_insulation_type` but NOT
+  `cylinder_insulation_thickness` → `EpcPropertyData.sap_heating.cylinder_
+  insulation_thickness_mm` stays None even when the cert lodges it (e.g. 50 mm).
+  The engine then assumes a poorly-insulated cylinder → over-counts HW cylinder
+  loss → under-rates. Confirmed uprn_68151071 (raw 50 mm → mapped None; engine HW
+  3446 vs Elmhurst 2911 kWh; engine 68 vs lodged 70 / Elmhurst 71). FIX: map the
+  thickness in the RdSAP per-schema mapper; check blast radius (any pinned cylinder
+  cert may shift) + regress the RdSAP-21.0.1 corpus gauge. Leverage point — likely
+  improves every cylinder-with-lodged-thickness cert. Flagged, not yet fixed.
+- **Party-wall type `_pick` gotcha:** matching `"filled"` ALSO matches "Cavity
+  masonry **UN**filled" (CU, U≈0.5) — the wrong type for a cert whose party wall is
+  U≈0. Match `"masonry filled"` to hit CF (Cavity masonry filled, U≈0). Affects
+  cavity builds (10090844932 / 10091568921 / 10093718424 / 10093412452 used the
+  loose `"filled"` and may have got CU in Elmhurst — only the Elmhurst cross-check,
+  not the pinned engine value which is validated against lodged). Fixed for
+  uprn_10093115480.
+- **Shared-assessment reset: storage/electric → boiler cert.** The shared
+  assessment carries the PRIOR cert's heating system. Going storage→combi, the
+  boiler search dialog won't open while a SAP-table `MainHeatingCode` (e.g. SEB) is
+  set. Fix: JS-clear `MH1.TextBoxMainHeatingCode` to `''` + dispatch change, Save &
+  Close, then `select_boiler` works. Also RESET the electricity meter on the Meters
+  sub-tab (a prior off-peak cert leaves it Dual; gas certs want Single) and the
+  SECONDARY heating (a prior cert's secondary persists even when the calc shows
+  presence=No — set it explicitly or it pollutes the worksheet).
+- **Secondary heating must be built in Elmhurst when lodged.** Certs lodge a
+  secondary (`sap_heating.secondary_heating_type`, e.g. 612 = mains-gas room heater
+  @ Table 4a seasonal efficiency 0.20 — a low-eff decorative/old gas fire). The
+  engine models it (fraction 0.1 from Table 11 ÷ the secondary efficiency → e.g.
+  3065 kWh for code 612); omitting it in Elmhurst inflates the worksheet (uprn_
+  10023443426: omitted → 79 vs engine/lodged 76). Build via Secondary present=Yes →
+  `ButtonSecondaryHeatingCode` cascade (title "Select secondary heating"): fuel →
+  sub-fuel → appliance → type, e.g. Gas → Mains gas → Room Heaters → RGx (pick the
+  RGx whose efficiency matches the lodged code, ~0.20 = decorative/old gas fire).
+  ⚠ For a NATIVE RdSAP-21.0.1 cert, engine = lodged (exact, all components) is the
+  authoritative validation — if the Elmhurst rebuild diverges, suspect an omitted
+  lodged feature (secondary / meter), confirm via engine-on-Elmhurst-inputs ≈
+  worksheet, and pin the engine = lodged value.
+  ⚠ **`present=No` does NOT clear the shared assessment's leftover secondary** — the
+  prior cert's secondary SYSTEM (fuel + SAP code) persists server-side even when the
+  UI dropdown reads "No", and it silently re-enters the worksheet. On a storage-heater
+  cert (uprn_100020665611, RdSAP-20.0.0 end-terrace house) a leftover House-Coal
+  closed-room-heater (SAP 633, cheap solid fuel) inflated the Elmhurst worksheet to
+  44 vs engine 36 / lodged 37 until OVERWRITTEN. Always set the secondary EXPLICITLY
+  to the lodged appliance: storage-heater certs lodge "Portable electric heaters
+  (assumed)" → present=Yes → `ButtonSecondaryHeatingCode` cascade Electric → Electric
+  → Room Heaters → "REA Panel, convector or radiant heaters" (= SAP 691, eff 100%).
+  That dropped the worksheet 44 → 35 ≡ engine-on-Elmhurst-inputs 35 (faithful).
+- **Openings: standard double/triple-glazing bands REQUIRE Frame Type + Glazing Gap.**
+  The window grid's `DropDownListExtFrameType` (PVC/Wood/Metal) and
+  `DropDownListExtGlazingGap` (6 mm / 12 mm / 16 mm or more) are required for any
+  band other than the new-build "Double post or during 2022" default — leaving them
+  empty fails the Recommendations gate ("Openings: Frame Type / Glazing Gap must be
+  entered"). Set both in `_add_window` BEFORE clicking Add (cert `pvc_window_frames`
+  → PVC; `glazing_gap` mm → the band). Glazing bands available: Single / Double|Triple
+  {pre 2002, between 2002 and 2021, post or during 2022, with unknown install date} /
+  Secondary / *…known data*. For RdSAP double-glazing with no lodged install year
+  (engine U 2.8) pick "Double pre 2002" (~U3.1, sub-1-SAP diff) — the "…known data"
+  options demand per-row U/g values.
+- **Non-boiler (storage-heater) main heating — SOLVED** (uprn_10022893721, RdSAP-
+  18.0 GF flat, electric storage heaters + immersion). The SpaceHeating page has NO
+  inline system-type selector and a `ButtonMainHeatingCode` button only APPEARS
+  once the bound PCDF boiler is cleared. Two-pass recipe (one Save & Close each):
+  1. **Clear the leftover PCDB boiler**: set `MH1.TextBoxPCDFBoilerReference` to
+     `"0"` via JS + dispatch `change`, then `save_close`. (It doesn't AutoPostBack;
+     the Save commits it. After reload, boilerRef="0", the boiler fuel/flue fields
+     vanish, and `MH1.ButtonMainHeatingCode` is now present.)
+  2. **Select the SAP-table system** via `set_heating_dialog(..ButtonMainHeating
+     Code, "^Electric","^Electric","Storage","SEB Modern slimline")` (title "Select
+     heating code"; L1 Gas/Oil/Solid Fuel/Electric/Community/No heating; storage L4
+     = SEA old large-volume / SEB modern slimline / SED fan / SEJ integrated / SEK
+     high-heat-retention). **Match the cert's `sap_main_heating_code`**: 402 = SEB.
+     Then the CONTROL via `set_heating_dialog(..ButtonMainHeatingControls,
+     "Storage Radiator","CSA Manual charge control")` (= SAP 2401). Secondary No.
+  Water: `set_heating_dialog(..ButtonWaterHeatingCode, "Water Heater","^Electric",
+  "Immersion")` (→ code HEI) — then the immersion code REQUIRES a cylinder: CHECK
+  `WH.CheckBoxHotWaterCylinder` (JS click+change, AutoPostBacks) or Recommendations
+  errors "must have a Hot Water Cylinder"; set `WH.DropDownListCylinderSize`
+  (size 2→Normal/110L, 3→Medium/160L, 4→Large/210L), `WH.DropDownListInsulated`
+  (Foam/Jacket), `WH.DropDownListInsulationThickness`, and `WH.RadioButton
+  ListImmersionHeater` (off-peak meter → Dual). See `build_10022893721.py` as the
+  template. ⚠ **CRITICAL — set the electricity meter type.** All-electric off-peak
+  certs MUST set the Economy-7 meter or Elmhurst silently defaults to Single /
+  Standard and prices everything at the 13.19p standard rate (worksheet collapses
+  ~13 SAP). The control is a HIDDEN sub-tab on the SpaceHeating page:
+  `E.click_tab(page,"TabContainer_TabPanelMeters")` then `E.set_select(page,
+  "TabContainer_TabPanelMeters_RadioButtonListElectricityType","Dual")` (options
+  Single/Dual/18 Hour/24 Hour/Unknown; cert `meter_type` 1→Dual=7-hour off-peak).
+  Verify in Elmhurst summary §14.2 "Electricity meter type" / worksheet
+  "Electricity Tariff" before trusting the worksheet SAP.
+- **Economy-7 off-peak pricing is CORRECT — do NOT "fix" it** (was a real bug, FIXED
+  in PR #1217 via the Table 13 off-peak water-heating split + window-U fix). The
+  engine applies SAP Table 12a Grid 1 (space) + Table 13 (immersion DHW) high/low
+  splits properly: storage heaters' SH high-rate fraction is legitimately 0.00
+  (100% low rate), immersion HW takes the volume/occupancy/single-dual blend. Proof:
+  uprn_10002468137 (canonical) engine 60.92 = Elmhurst 61 to the penny;
+  uprn_10022893721 engine 79 = lodged 79, Elmhurst (Dual meter) 81. ⚠ If you see a
+  big engine-over-Elmhurst gap on an all-electric off-peak cert, SUSPECT THE BUILD
+  (Elmhurst meter left on Single — see meter step above), not the calculator. The
+  `reference/mapping.md` "known over-rating bug (engine 62)" note is STALE (pre-PR
+  #1217). `cert_to_inputs.py` `_hot_water_fuel_cost_gbp_per_kwh` applies the immersion
+  Table 13 blend when cylinder volume + occupancy resolve; when `immersion_heating_
+  type` is UNLODGED on an off-peak meter it now defaults to DUAL per RdSAP §10.5
+  (was a 100%-low-rate fallback that under-costs — fixed, +regression test
+  `test_off_peak_immersion_unlodged_type_defaults_to_dual_table13_blend`). Only an
+  unresolvable cylinder volume / occupancy still falls back to 100% low.
+- **Air-permeability AP50 fix** (uprn_10093116528, the first campaign cert): the
+  full-SAP mapper was routing the lodged q50 to the engine's AP4/Pulse formula
+  (`0.263×AP4^0.924`) instead of the AP50 `/20` path — a big infiltration
+  over-count. Fixed via `SapVentilation.air_permeability_ap50_m3_h_m2` +
+  `_sap_17_1_ventilation` + `cert_to_inputs`. Re-pinned uprn_10092973954 77→80.
+  See `epc-to-elmhurst-rdsap-inputs/reference/mapping.md` (Air permeability).
+- **Full-SAP-through-RdSAP residual ≈ +1–2 SAP** is expected and usually NOT a
+  bug: the engine uses the cert's *measured* U-values (often better than RdSAP
+  age-band proxies) and Elmhurst RdSAP uses age-band defaults + a party-wall
+  default. Pin the engine's observed value; document the Elmhurst delta (don't tune).
+- **FGHRS** (full-SAP `has_fghrs`/`fghrs_index_number`) is dropped by the mapper
+  and not yet modelled — omit it on BOTH sides so the comparison stays clean.
+- **Validation errors live on the Recommendations page as LINKS** (red ✗ anchors),
+  not coloured spans — parse `[id*=ContentPlaceHolder1] a` text, not CSS colour.
+  Until Recommendations shows ZERO errors the **Energy Report Summary nav silently
+  redirects to the Address page** and the worksheet/Results PDFs won't generate
+  (Results renders empty). Two errors that bit the 16.1/19.1.0 builds: *"Walls
+  (Main): Insulation Thickness must be entered"* (set the insulation-thickness
+  dropdown — "Unknown" is fine for a reduced cert) and *"Incorrect Controls (NNNN
+  ctrl-group-X) for Heating System (idx ctrl-group-Y)"* (the heating control's
+  system-type must match the boiler's — see the controls dialog below).
+- **All Elmhurst modal dialogs sit above a `modalBackground` that defeats element
+  clicks** (Playwright sees it "intercepting pointer events", even with force).
+  The cracked pattern is now in `elmhurst_lib.py`: open via JS click, set cascade
+  `<select>`s by JS (`.value` + dispatch `change` → drives the AutoPostBack), and
+  COMMIT by `page.mouse.click(x,y)` at the OK/Select control's centre (coordinate
+  clicks hit the topmost element = the dialog). Helpers: `E.select_boiler(page,
+  query, ref)`, `E.set_heating_dialog(page, button_suffix, *level_regexes)` (water
+  method + main-heating controls), `E.dialog_commit(page, label)`,
+  `E.clear_hot_water_cylinder(page)`.
+- **Boiler by exact PCDB code** (eliminates the boiler-efficiency divergence):
+  `E.select_boiler(page, "<brand/model search>", "<pcdb_id>")` drives the search
+  dialog two-step (click the result ROW to highlight → click the top **Select**
+  span). The lodged `main_heating_index_number` IS the `pcdb_id`. Look up the Ref/
+  type/efficiency in **`domain/elmhurst/pcdb_gas_oil_boiler_codes.csv`**. NB:
+  typing the number straight into the *PCDF boiler Reference* box is COSMETIC — it
+  doesn't re-resolve the boiler; only the search dialog sets type/efficiency. A
+  combi keeps the cylinder checked from a prior regular boiler → `clear_hot_water_
+  cylinder()`, then set water method "From Space Heating → primary" via
+  `set_heating_dialog(..ButtonWaterHeatingCode, 'From Space Heating', 'From the
+  primary heating system')`.
+- **Reduced-field (16.x) semi/terraced party wall.** 16.x lodges no
+  `party_wall_length`, so the engine models NO party wall (defaults 0). But
+  Elmhurst REJECTS a semi/terraced with a zero party wall ("At least one building
+  part must have a party wall length of non zero"). Enter the geometry-derived
+  length (solve `2w+d=heat_loss_perimeter`, `w*d=floor_area`; party wall = the
+  joined side `d`) on every floor + a filled-cavity party-wall type (CF), and
+  EXPECT engine to over-read Elmhurst by ~1–2 SAP (engine's no-party-wall vs
+  Elmhurst's forced one). That delta is the documented reduced-field gap, not a
+  bug — confirm via engine-on-Elmhurst-inputs ≈ worksheet. Pin the engine value.
+- **Main-heating control must match the boiler's system type.** Heat-pump leftover
+  control (e.g. CHJ/2210, ctrl-group-2) is invalid for a gas boiler (ctrl-group-1)
+  and blocks the report. For a boiler programmer+room-stat+TRVs (SAP 2106):
+  `set_heating_dialog(..ButtonMainHeatingControls, '^Boilers', '^Standard', 'CBE
+  Programmer, room thermostat and TRVs')`.
+  ⚠ **Zone-control codes are under L2 "Zone control", NOT "Standard".** SAP 2110
+  "Time and temperature zone control" = `set_heating_dialog(.., '^Boilers', 'Zone
+  control', 'CBI Time and temperature zone control')` (Boilers→Standard L3 only has
+  CBA…CBH — no zone option, so a wrong L2 leaves the cascade incomplete and the OK
+  click is swallowed by the modalBackground, hanging the run). CBL is the PCDF
+  variant. Match the lodged `main_heating_control`: 2110 → CBI, 2106 → CBE (Standard).
+- **Removing an inherited secondary when the cert lodges NONE** — `present=No` ALONE
+  does NOT remove it: a persisted secondary CODE (e.g. an electric REA/691 from a
+  prior cert) survives the dropdown=No and the worksheet still applies it at Table-11
+  fraction 0.1 (worth ~1.5 SAP on a gas-combi cert — the electric secondary is priced
+  at the 13.19p peak rate vs gas 3.48p). The flag and the code are independent; the
+  worksheet keys off the CODE. ✅ FIX: `present=Yes` (exposes `TextBoxSecondaryHeating
+  Code`) → JS-clear that textbox to `''` + dispatch change → `present=No` → Save&Close.
+  An EMPTY code drops the worksheet's "Secondary Heating" to None / fraction 0.0.
+  Verify by re-downloading: worksheet line (201) "Fraction of space heat from
+  secondary" must read 0.0000. Seen on uprn_10090944225 (worksheet 79→80; closed the
+  cross-check gap to the residual +1 floor-U difference).
+
+## Limitations / next improvements (make the campaign scale)
+- **Per-assessment GUID** — `elmhurst_lib.py` reuses one `ASSESSMENT_GUID`
+  (Khalim-test), overwritten per UPRN. ⚠ This is a SHARED assessment: a concurrent
+  user (Khalim) overwrote a build mid-session once — coordinate before long runs,
+  or (better) create one assessment per UPRN and parameterize the GUID.
+- **Data-driven fill** — `build_<uprn>.py` per-cert scripts now drive every page
+  incl. all dialogs via the `elmhurst_lib` helpers (see build_100021943298.py /
+  build_10096028301.py as templates). A generic driver reading `elmhurst_inputs.md`
+  is the remaining step. `elmhurst_fill.py` is the older single-cert template.
+- **Per-schema mappers** — every SAP/RdSAP schema gets its own dedicated
+  `from_*_schema_*` mapper in `datatypes/epc/domain/mapper.py` (the 16.x family
+  shares `_normalize_sap_schema_16_x`; full-SAP revisions delegate to
+  `from_sap_schema_17_1`). Add new schema coverage as a dedicated method + dispatch
+  branch, never by tuple-stuffing. Guard with the RdSAP-21.0.1 corpus gauge.

.claude/skills/expand-sap-accuracy-corpus/start-prompt.md

@@ -0,0 +1,39 @@
+# Start prompt — run the corpus campaign one UPRN at a time
+
+Paste the block below into Claude to process the **next** UPRN. It does exactly
+one UPRN and stops; reply **"next"** (or re-paste) to advance. Reuses the single
+Elmhurst assessment/GUID and overwrites it each time — the EPC-API ↔ Input-Summary
+diff in the Compare step is the safety net for leftover state.
+
+---
+
+```
+Run the `expand-sap-accuracy-corpus` skill to process the NEXT UPRN, ONE at a time.
+
+1. Open `.claude/skills/expand-sap-accuracy-corpus/worklist.md` and take the first `[ ]` UPRN.
+2. Run that single UPRN through the skill's loop:
+   - Capture: `PYTHONPATH=/workspaces/model python scripts/fetch_real_life_epc_sample.py <uprn>`.
+     If it prints NOT MAPPABLE (schema uncovered), that's the job — extend the
+     EpcPropertyDataMapper for that schema generically, then re-run. Guard with the
+     RdSAP-21.0.1 corpus gauge.
+   - Inputs: run the `epc-to-elmhurst-rdsap-inputs` skill on the UPRN → complete
+     `elmhurst_inputs.md` (with the "Fields to clear" section).
+   - Build in Elmhurst, REUSING the existing assessment:
+     GUID B44A0DB4-4C08-4241-B818-86F060172105 (the "Khalim-test" cert).
+     `bash scripts/hyde/start_viewer.sh` (noVNC on :99). The filler's PAGES values
+     are from the previous cert — update them to THIS cert's values from the new
+     `elmhurst_inputs.md` (it's one-at-a-time, so editing the specs is fine), set
+     AND clear every field (overwrite the prior UPRN's state — use the Fields-to-clear
+     list), and key the 🔸 dialog fields by hand. Then run `elmhurst_download.py`
+     to save `elmhurst_summary.pdf` + `elmhurst_worksheet.pdf` into the sample dir.
+     NEVER click Submit.
+   - Compare: `PYTHONPATH=/workspaces/model python scripts/compare_epc_paths.py <uprn>`.
+   - Reconcile to ≤0.5 SAP: fix mapper gaps GENERICALLY (never tune to one cert);
+     Elmhurst's Input Summary diff localises them. Cosmetic diffs are noise.
+   - Pin a RealCertExpectation in
+     tests/domain/sap10_calculator/test_real_cert_sap_accuracy.py and run it.
+     Use strict known_bug_xfail for a known engine bug instead of widening.
+   - Update that worklist line: [x]/🔧/⚠/⛔ — <schema> · eng <X> / elm <Y> · <note>.
+3. STOP after this one UPRN. Report: schema, any mapper changes, engine vs Elmhurst
+   SAP and what reconciled them, and the test result. Then wait for me to say "next".
+```

.claude/skills/expand-sap-accuracy-corpus/worklist.md

@@ -0,0 +1,153 @@
+# SAP accuracy corpus — UPRN worklist
+
+Process **one at a time**, top to bottom (see [SKILL.md](SKILL.md)). After each
+UPRN, tick it and annotate: `— <schema> · eng <X> / elm <Y> · <note>`.
+
+**Legend:** `[ ]` todo · `[x]` pinned (≤0.5) · `🔧` mapper extended · `⚠` xfail
+(engine bug) · `⛔` blocked · `[🔍]` flagged — engine vs Elmhurst-worksheet gap too
+large, or a new/complex build pattern needed; NEEDS INVESTIGATION.
+
+**Worked reference (not in the 100):** `uprn_10092973954` (SAP-Schema-17.1,
+2020 new-build flat) — full loop proven: eng 77 / elm 78, engine-on-Elmhurst-
+inputs 79 (calculator faithful within ~1). Use it to sanity-check the pipeline.
+
+## Do next — new schemas (need a mapper)
+
+These two were flagged NOT MAPPABLE in the UI (red ✗). Mapper coverage now ADDED
+(dedicated per-schema methods in `EpcPropertyDataMapper`; corpus gauge green, 0
+new pyright errors). Elmhurst build + pin still pending — run the normal loop.
+
+- [x] 🔧 10096028301 — SAP-Schema-19.1.0 (full-SAP g/f FLAT, band M, combi PCDB 17929, MEV, AP50 3.5) · eng 82 / elm 82 (lodged 85) · PINNED engine 82. 🔧 mapper added: `from_sap_schema_19_1_0`. Built in Elmhurst (boiler 17929 via search, control CBE/2106, water from primary, MEV on, AP50 Blower Door 3.5+cert). Engine EXACTLY matches Elmhurst worksheet (82.11 vs 82); engine-on-Elmhurst-inputs 82.16 ≈ 82 → calculator faithful. −3 vs lodged = measured-U-vs-RdSAP-default + MEV extract-not-recovery (documented). No mapper change beyond coverage.
+- [x] 🔧 100021943298 — SAP-Schema-16.1 (g/f FLAT, band B, solid-brick internal, combi PCDB 10328) · eng 76 / elm 75 (lodged 72) · PINNED engine 76. 🔧 mapper added: `from_sap_schema_16_1`. Built in Elmhurst (boiler 10328 via search, control CBE/2106, water from primary, wall insulation thickness Unknown); worksheet 75 → engine within ~1 (tightest agreement, reduced-field). Boiler-select + water-heating + control dialogs all driven via automation (two-step row→Select / cascade + coordinate-OK). No mapper change beyond coverage.
+
+(Refactor: split the full-SAP + 16.x dispatch tuples into dedicated per-schema
+mappers — from_sap_schema_17_0/18_0_0/19_1_0 + from_sap_schema_16_0/1/2/3 — so
+each schema has one mapper home for future divergence; all delegate to shared logic.)
+
+## E2E testing set
+
+UPRNs needed for end-to-end testing (also tracked in The 100 below).
+
+| UPRN | Schema | Status | Engine SAP | Notes |
+|---|---|---|---|---|
+| 10093116528 | SAP-17.1 | ✅ pinned | 82 (elm 81) | full-SAP semi; AP50 fix |
+| 10093116543 | SAP-17.1 | ✅ pinned | 81 (elm 77) | 2017 gas-combi semi |
+| 10093116529 | SAP-17.1 | ✅ pinned | 81 (elm 78) | 2017 gas-combi g/f flat; party-wall fix |
+| 100020933699 | SAP-16.2 | 🔧 mapper + glazing fix | 71 (lodged 70) | RdSAP-shaped; single-glazing fix; Elmhurst validation pending |
+| 44012843 | SAP-16.3 | 🔧 mapper added | 79 (lodged 81) | same 16.x reduced-field path; Elmhurst pending |
+| 10023444324 | SAP-17.0 | 🔧 mapper added | 80 (lodged 82) | full-SAP shape = 17.1; Elmhurst pending |
+| 10023444320 | SAP-17.0 | 🔧 mapper added | 81 (lodged 81) | full-SAP shape = 17.1; Elmhurst pending |
+
+**All 7 e2e UPRNs now map and produce engine SAP scores.** Schema coverage added this session: SAP-16.2, SAP-16.3 (reduced-field → RdSAP-17.1 path), SAP-17.0 (full-SAP → 17.1 path).
+
+## Strategy note (2026-06-17)
+Doing the **similar certs first** for speed: the `10093116xxx` series are all
+2017 Emsworth new-builds (full-SAP, mains-gas combi, measured U-values), so the
+Elmhurst assessment config (House/Semi or bungalow · band L · cavity/As-Built ·
+pitched/Unknown roof · combi/no-cylinder) is reused per cert — each build is
+fast. Pattern is rock-solid: engine ≈ lodged−1, Elmhurst worksheet ≈ engine−4/5
+(documented full-SAP→RdSAP residual). Pin the engine value. DONE: 528/543/529/324.
+Skip the 🚩 MVHR / 🚩 heat-pump-fuel and ⛔ sparse certs.
+
+## The 100
+
+- [x] 🔧 10093116528 — SAP-17.1 (full-SAP semi) · eng 82 / elm 81 · 🔧 air-perm AP50 fix: q50 Blower-Door routed to (18)=AP50/20 not the AP4/Pulse formula (was eng 78). Residual +1 = lodged-U vs RdSAP age-band-U; FGHRS (60031) omitted both sides. Worked-ref 10092973954 re-pinned 77→80 by same fix.
+- [x] 10093116543 — SAP-17.1 (2017 gas-combi semi) · eng 81 / elm 77 (lodged 82) · PINNED engine 81. +4 = documented full-SAP→RdSAP residual, NOT a mapper bug: ~1.5 floor-U (cert lodges measured 0.11 vs Elmhurst RdSAP solid default 0.23; U-known override disabled) + ~1 boiler-eff (cert PCDB 17644 88.5% vs Elmhurst generic BGW combi 84%; PCDB search disabled, 89% cascade option is a regular boiler needing a cylinder) + ~0.5 roof band-L/infil. Conservatory leftover from prior cert cleared (worksheet 73→77). No mapper change.
+- [x] 🔧 10093116529 — SAP-17.1 (2017 gas-combi ground-floor FLAT, TFA 49) · eng 81 / elm 78 (lodged 81) · PINNED engine 81. 🔧 FIXED a real calc bug: full-SAP flats took the 0.25 house party-wall default instead of the RdSAP Table-15 flat 0.0 (flatness is in dwelling_type, not property_type) — heat_transmission._is_flat_or_maisonette_dwelling; +regression test. Cert lodges party u_value 0; Elmhurst worksheet 0.0; fix 80→81. Residual +3 vs Elmhurst = documented full-SAP→RdSAP gap (measured wall 0.184/floor 0.12 + PCDB 88.5% vs generic 84%). Calculator faithful: fed Elmhurst's Us, HTC 93.4 vs ~94. House→Flat Elmhurst switch (storeys→1, roof→another-dwelling-above). No mapper change.
+- [ ] 🔧 100020933699 — SAP-16.2 SCHEMA COVERAGE ADDED (end-terrace house, band G). 16.2 is structurally RdSAP-17.1 (reduced fields, glazed_area band, construction-code building parts) under a different name; mapped via `_normalize_sap_schema_16_2` (renames windows→window, main_gas→mains_gas, boiler_index_number→main_heating_index_number, wwhrs→instantaneous_wwhrs + defaults) → reuses from_rdsap_schema_17_1. 🔧 Also fixed: "Single glazed" description honoured when multiple_glazing_type="ND" (was defaulting to double; RdSAP-21 code 5) → eng 72→71. +4 regression tests, sap_16_2.json fixture, 0 new pyright errors. eng 71 / lodged 70. ⚠ Known gap: 16.2 lodges no party_wall_length → end-terrace party wall unmodelled (likely the residual +1). ⏳ Elmhurst build (partial: PropDesc/Dims/Walls/Roofs done) + pin still pending.
+- [x] 🔧 44012843 — SAP-16.3 (g/f FLAT, band K, cavity insulated, REGULAR boiler PCDB 9895 + cylinder, double glazed) · eng 79 / elm 78 (lodged 81) · PINNED engine 79. Built in Elmhurst (boiler 9895 via search, control CBE/2106, cylinder Large/foam/50mm, water from primary). Engine within ~1 (78.82 vs 78); engine-on-Elmhurst-inputs 78.48 ≈ 78 → calculator faithful. −2 vs lodged = reduced-field defaults. No mapper change beyond coverage.
+- [x] 🔧 10023444324 — SAP-17.0 (full-SAP g/f FLAT, band M, combi PCDB 16211, MEV, AP50 3.2, party wall 6.43) · eng 80 / elm 80 (lodged 82) · PINNED engine 80. Built in Elmhurst (boiler 16211 via search, control CBE/2106, water from primary, MEV on, AP50 Blower Door 3.2, party wall 6.43). Engine EXACTLY matches Elmhurst worksheet (80.13 vs 80); engine-on-Elmhurst-inputs 81.03 ≈ 80 → calculator faithful. −2 vs lodged = full-SAP→RdSAP residual (measured U + MEV). No mapper change beyond coverage.
+- [⚠] 10092970673 — SAP-17.0 · eng 77 / lodged 86 · 🚩 MVHR idx 500418 not credited (flagged)
+- [⚠] 10094601287 — SAP-18.0.0 · eng 80 / lodged 84 · 🚩 MVHR idx 500230 not credited (flagged)
+- [x] 10090844932 — RdSAP-20.0.0 (end-terrace HOUSE 2-storey, band L, combi PCDB 10327, party wall 4.93, 250mm loft) · eng 78 / elm 77 (lodged 78) · PINNED engine 78. Built in Elmhurst (House, boiler 10327 via search, control CBE/2106, water from primary, party wall 4.93 filled). Within ~1 (78.13 vs 77); engine-on-Elmhurst-inputs 77.24 ≈ 77 → faithful.
+- [⛔] 10090844948 — SAP-16.3 · NOT MAPPABLE (ValueError: RdSapSchema17_1: missing required field )
+- [x] 100090182288 — SAP-16.2 (semi-detached HOUSE 2-storey, band D, filled cavity, combi PCDB 10327, double glazed) · eng 71 / elm 69 (lodged 71) · PINNED engine 71. Built in Elmhurst (semi, boiler 10327, control CBE/2106, water from primary, party wall 4.28 filled — Elmhurst requires non-zero for a semi). +2 vs Elmhurst = documented 16.2 reduced-field party-wall gap (gov-API lodges no party_wall_length → engine models none); engine-on-Elmhurst-inputs 69.35 ≈ worksheet 69 → calculator faithful.
+- [⚠] 10093114053 — SAP-17.0 · eng 93 / lodged 79 · 🚩 heat-pump fuel-39 (flagged)
+- [x] 10091568921 — SAP-17.1 (full-SAP END-TERRACE HOUSE 2-storey, band L 2018, combi PCDB 17615 Potterton Promax Ultra, party wall 40.56m², natural vent + 3 extract fans, AP50 4.45, 20 LED, measured U 0.18/0.10/0.15) · eng 82 / elm 80 (lodged 85) · PINNED engine 82. Built in Elmhurst (end-terrace house, boiler 17615, CBE/2106, water from primary, party wall 8.45 filled, AP50 Blower Door 4.45+cert). +2 = documented full-SAP→RdSAP residual (measured U beats band-L defaults); engine-on-Elmhurst-inputs 80.16 ≈ worksheet 80 → faithful. has_hot_water_cylinder lodged true but combi PCDB + no cylinder detail → built combi. No mapper change.
+- [x] 10093718424 — SAP-17.1 (full-SAP SEMI-DETACHED HOUSE 2-storey, band L, combi PCDB 17615, party wall 40.89m², natural vent + 3 extract fans, AP50 4.18, 20 LED, measured U 0.25/0.13/0.16; sibling of 10091568921) · eng 81 / elm 80 (lodged 84) · PINNED engine 81. +1 = documented full-SAP→RdSAP residual; engine-on-Elmhurst-inputs 80.12 ≈ worksheet 80 → faithful. Built combi (cylinder lodged true but combi PCDB). No mapper change.
+- [x] 10022893721 — RdSAP-18.0 (GF FLAT, band I, cavity insulated, ELECTRIC STORAGE HEATERS SAP 402 SEB Modern slimline + manual charge CSA/2401, immersion off-peak dual + cylinder Normal/110L foam 50mm, party wall 21.48) · eng 79 / elm 81 (lodged 79) · PINNED engine 79 = lodged. Built in Elmhurst (storage SEB, CSA control, immersion dual + cylinder, **Dual electricity meter / Economy 7**). engine -2 vs Elmhurst, within tolerance; engine-on-Elmhurst-inputs 78.76 ≈ 79 → faithful. Economy-7 off-peak pricing is CORRECT (Table 12a/13, fixed PR #1217) — NOT a bug. ⚠ Earlier mis-build left Elmhurst meter on Single/Standard → bogus worksheet 66; fixed by setting Dual meter on the Meters sub-tab. 🔧 First non-boiler cert — SOLVED storage-heater automation (see banked findings: clear PCDB boiler → ButtonMainHeatingCode Electric→Electric→Storage→SEB; set Dual meter). build_10022893721.py complete.
+- [x] 10023443426 — RdSAP-21.0.1 (END-TERRACE HOUSE 2-storey, band L, cavity insulated, combi PCDB 17045 Ideal Logic ES35, 300mm loft, party wall 9.2 lodged, 11 dbl-glazed windows ~10.3m², 9 LED, mains-gas room-heater SECONDARY code 612 eff 0.20) · eng 76 / elm 79 (lodged 76) · PINNED engine 76 = lodged EXACTLY (native RdSAP-21.0.1 schema; reproduces every component: space 6129/main 6247/HW 2752/CO2 2232). Elmhurst +3 is a BUILD gap — my build omitted the lodged secondary gas fire (engine models it 3065 kWh = 0.1÷0.20); engine-on-Elmhurst-inputs 79.29 ≈ worksheet 79 → calculator faithful. NB: shared-assessment storage→combi reset needed (clear leftover MainHeatingCode) + meter reset to Single. build_10023443426.py.
+- [x] 10093412452 — SAP-17.1 (full-SAP END-TERRACE HOUSE 2-storey, band L, combi PCDB 17615, party wall 41.01m², natural vent + 3 extract fans, AP50 4.62, 20 LED, measured U 0.25/0.13/0.16; sibling of 10093718424/10091568921) · eng 81 / elm 80 (lodged 84) · PINNED engine 81. +1 = documented full-SAP→RdSAP residual; engine-on-Elmhurst-inputs 79.91 ≈ worksheet 80 → faithful. Built combi (cylinder lodged true but combi PCDB). No mapper change.
+- [⛔] 10014314798 — SAP-16.2 · NOT MAPPABLE (ValueError: RdSapSchema17_1: missing required field )
+- [⚠] 10094601294 — SAP-18.0.0 · eng 81 / lodged 84 · 🚩 MVHR idx 500230 not credited (flagged)
+- [🔍] 10090343335 — SAP-17.0 (full-SAP SEMI-DETACHED HOUSE, 3-storey incl. ROOM-IN-ROOF top floor h1.95, combi PCDB 16841 Vaillant ecoTEC plus 824, party wall 48.51m², 10 windows 18.46m² + 1 ROOF WINDOW type-12 2.31m², 3 doors, AP50 3.98, 10 LED, measured U walls 0.18/roof 0.15/floor 0.13, TFA 122) · eng 86 / lodged 88 · 🔍 FLAGGED — NEEDS NEW BUILD PATTERN: room-in-roof + roof-window not covered by templates (Elmhurst DIM panel only exposes 2 floors; room-in-roof entered via RoomInRoofMain age-band + separate RiR dimensions TBD; roof window type-12 entry TBD). Elmhurst build + worksheet comparison pending. Skipped in autonomous sweep to keep momentum; revisit with a dedicated room-in-roof build.
+- [x] 10093115480 — SAP-17.1 (full-SAP END-TERRACE BUNGALOW single-storey, band L 2016, combi PCDB 16841, party wall 10.99m² CF filled, natural vent + 2 fans, AP50 3.85, 9 LED, measured U 0.19/0.11/0.12, TFA 56) · eng 81 / elm 78 (lodged 81) · PINNED engine 81 = lodged EXACT. +3 = documented full-SAP→RdSAP residual (measured U beats band-L defaults); engine-on-Elmhurst-inputs 78.29 ≈ worksheet 78 → faithful. Built combi. No mapper change.
+- [🔍] 68151071 — RdSAP-17.0 (semi-detached BUNGALOW single-storey, band H 1991-1995, cavity insulated, REGULAR boiler PCDB 17550 Worcester Greenstar 18Ri + cylinder size2/foam/50mm, pitched 200mm loft, suspended uninsulated floor, party wall 9.48 lodged, TFA 50) · eng 68 / elm 71 (lodged 70) · 🔍 FLAGGED — MAPPER GAP (cylinder insulation thickness dropped). engine -3 vs Elmhurst, -2 vs lodged; engine HW 3446 kWh vs Elmhurst 2911. ROOT CAUSE confirmed: raw cert lodges sap_heating.cylinder_insulation_thickness=50 but the RdSAP-17.0 mapper maps cylinder_size + cylinder_insulation_type only, leaving EpcPropertyData.sap_heating.cylinder_insulation_thickness_mm=None → engine assumes a poorly-insulated cylinder → over-counts HW cylinder loss → under-rates. FIX: carry cylinder_insulation_thickness → cylinder_insulation_thickness_mm in the RdSAP mapper (check blast radius across schemas + regression). engine-on-Elmhurst-inputs 71.34 ≈ worksheet 71 → calculator faithful (gap is purely the dropped input). build_68151071.py + evidence saved.
+- [x] 100021985993 — SAP-16.2 (END-TERRACE BUNGALOW single-storey, band C, solid-brick internal insulation, combi PCDB 10328, double glazed, 100mm loft, suspended uninsulated floor) · eng 74 / elm 72 (lodged 70) · PINNED engine 74. Built in Elmhurst (end-terrace, boiler 10328, control CBE/2106, water from primary, party wall 6.89 solid masonry — Elmhurst requires non-zero for an end-terrace). +2 vs Elmhurst = documented 16.2 reduced-field party-wall gap (gov-API lodges no party_wall_length → engine models none; worksheet's only extra element is party wall 16.19m²×U0.25=4.05 W/K ≈ 2 SAP). engine-on-Elmhurst-PDF-inputs 67 is PDF-parser noise (HW over-parsed), not a calc bug.
+- [x] 100020665611 — RdSAP-20.0.0 (END-TERRACE HOUSE 2-storey, band E 1967-1975, cavity UNINSULATED, ELECTRIC STORAGE HEATERS SAP 402 SEB + manual charge CSA/2401, immersion off-peak Economy-7 Dual + cylinder Normal/110L foam 38mm, double glazed PVC, party wall 9.5m/floor U0.25, secondary portable electric heaters/SAP 691, TFA 87.4) · eng 36 / elm 35 (lodged 37) · PINNED engine 36. Built in Elmhurst (storage SEB, CSA control, immersion Dual + cylinder, **Dual electricity meter**, secondary electric room heater). engine-on-Elmhurst-inputs 35 ≡ worksheet 35 → calculator faithful; eng 36 ≈ lodged 37 (−1). Cylinder thickness 38mm correctly carried by RdSAP-20.0.0 mapper (no cylinder-gap here). ⚠ Secondary had to be set EXPLICITLY: shared-assessment leftover House-Coal secondary (633) survived `present=No` and inflated worksheet to 44 until overwritten with electric room heater. build_100020665611.py. No mapper change.
+- [⚠] 10093388044 — SAP-17.1 · eng 87 / lodged 93 · 🚩 heat-pump fuel-39 (flagged)
+- [x] 10090944225 — SAP-17.0 (full-SAP GROUND-FLOOR FLAT, band L 2015, combi PCDB 17045 Ideal Logic Combi ES35, control 2110 CBI time+temp zone, NATURAL vent + 2 extract fans, AP50 3.48, party wall 3.41m² U0, measured U walls 0.27/floor 0.14/window 1.41, TFA 49.97, no cylinder/no secondary) · eng 81 / elm 80 (lodged 82) · PINNED engine 81. Built in Elmhurst (boiler 17045 via search, control CBI/2110 under Boilers→Zone control, water from primary, AP50 Blower Door 3.48+cert, Single meter). engine-on-Elmhurst-inputs 80 = worksheet 80 (exact) → faithful; eng 81 ≈ lodged 82 (−1). Remaining +1 = documented full-SAP→RdSAP residual localised to the FLOOR (cert measured U 0.14 vs Elmhurst RdSAP solid default 0.23; walls/party match) — engine correctly uses measured 0.14, NOT a mapper bug. ⚠ Initial worksheet read 79 due to a spurious leftover REA/691 electric secondary (Table-11 frac 0.1, ~1.5 SAP) the shared assessment retained — REMOVED via present=Yes→clear secondary code to empty→present=No (79→80). 🔧 Build notes: storage→combi reset (clear leftover SEB MainHeatingCode pass-1, reset meter Single); control 2110 is Boilers→**Zone control**→CBI (not Standard). No mapper change.
+- [⚠] 10090341811 — SAP-17.0 · eng 80 / lodged 89 · 🚩 MVHR idx 500352 not credited (flagged)
+- [ ] 10010215568 — RdSAP-17.1 · eng 75 / lodged 74
+- [⚠] 10093117227 — SAP-17.1 · eng 90 / lodged 80 · 🚩 heat-pump fuel-39 (flagged)
+- [⚠] 10023444170 — SAP-17.0 · eng 80 / lodged 83 · 🚩 MVHR idx 500167 not credited (flagged)
+- [ ] 100020980961 — SAP-16.3 · eng 66 / lodged 65
+- [ ] 200003714056 — RdSAP-20.0.0 · eng 72 / lodged 74
+- [⚠] 10094601280 — SAP-18.0.0 · eng 81 / lodged 84 · 🚩 MVHR idx 500230 not credited (flagged)
+- [⚠] 10093386418 — SAP-17.1 · eng 81 / lodged 82 · 🚩 MVHR idx 500230 not credited (flagged)
+- [⚠] 100090108846 — RdSAP-20.0.0 · eng 64 / lodged 79 · 🚩 heat-pump fuel-39 (flagged)
+- [x] 10093116324 — SAP-17.1 (2017 gas-combi semi-detached BUNGALOW, TFA 52) · eng 79 / elm 74 (lodged 80) · PINNED engine 79. +5 = documented full-SAP→RdSAP residual (measured wall 0.19/floor 0.12/roof 0.12 + PCDB combi 17505 88.5% vs Elmhurst RdSAP band-L defaults + generic 84%). Build clean (storeys=1, no conservatory). No mapper change.
+- [ ] 10094895444 — SAP-18.0.0 · eng 82 / lodged 85
+- [⚠] 10092973960 — SAP-17.1 · eng 80 / lodged 84 · 🚩 MVHR idx 500229 not credited (flagged)
+- [ ] 10012028763 — SAP-17.1 · eng 85 / lodged 83
+- [ ] 10093049867 — SAP-17.0 · eng 81 / lodged 87
+- [x] 10093116336 — SAP-17.1 (2017 gas-combi semi-detached HOUSE 2-storey, TFA 91) · eng 83 / elm 79 (lodged 84) · PINNED engine 83. +4 = documented full-SAP→RdSAP residual. Build clean (storeys=2). No mapper change.
+- [ ] 100020235156 — SAP-16.2 · eng 75 / lodged 74
+- [x] 10093116334 — SAP-17.1 (2017 gas-combi semi-detached BUNGALOW, TFA 52, sibling of 324) · eng 81 / elm 77 (lodged 82) · PINNED engine 81. +4 = documented full-SAP→RdSAP residual (measured U + PCDB combi 17505 88.5% vs RdSAP band-L defaults + generic 84%). Build clean. No mapper change.
+- [⛔] 10014314853 — SAP-16.3 · NOT MAPPABLE (ValueError: RdSapSchema17_1: missing required field )
+- [ ] 10013924849 — RdSAP-21.0.1 · eng 82 / lodged 80
+- [ ] 100062116493 — SAP-16.2 · eng 69 / lodged 68
+- [⚠] 10091636116 — SAP-17.0 · eng 80 / lodged 88 · 🚩 MVHR idx 500249 not credited (flagged)
+- [ ] 10093049853 — SAP-17.0 · eng 82 / lodged 87
+- [ ] 10093390790 — SAP-17.1 · eng 79 / lodged 82
+- [x] 10093116330 — SAP-17.1 (2017 gas-combi 2-storey semi HOUSE, TFA 73) · eng 82 / elm 78 (lodged 83) · PINNED engine 82. +4 = documented full-SAP→RdSAP residual. Build clean. No mapper change.
+- [ ] 10093116326 — SAP-17.1 · eng 82 / lodged 82
+- [ ] 10090317693 — SAP-17.0 · eng 81 / lodged 88
+- [ ] 10090034872 — SAP-17.0 · eng 83 / lodged 85
+- [ ] 10093115985 — SAP-17.1 · eng 81 / lodged 83
+- [ ] 10023230742 — RdSAP-17.0 · eng 78 / lodged 81
+- [ ] 10009432998 — RdSAP-19.0 · eng 78 / lodged 78
+- [ ] 100022015916 — SAP-16.3 · eng 67 / lodged 66
+- [⚠] 202211170 — SAP-17.0 · eng 82 / lodged 89 · 🚩 MVHR idx 500438 not credited (flagged)
+- [ ] 200003400077 — SAP-16.3 · eng 68 / lodged 70
+- [ ] 100061795739 — RdSAP-17.0 · eng 72 / lodged 65
+- [⚠] 10093305101 — SAP-17.1 · eng 81 / lodged 85 · 🚩 MVHR idx 500140 not credited (flagged)
+- [ ] 100020933894 — SAP-16.0 · eng 61 / lodged 56
+- [ ] 100020937013 — RdSAP-20.0.0 · eng 70 / lodged 73
+- [x] 🔧 10023444320 — SAP-17.0 (full-SAP MID-FLOOR FLAT, sibling of 324, combi PCDB 16211, MEV, AP50 3.09, no party wall) · eng 81 / elm 82 (lodged 81) · PINNED engine 81. Built in Elmhurst (boiler 16211, control CBE/2106, water from primary, MEV, AP50 3.09, mid-floor=floor to dwelling below). Within ~1 (81.38 vs 82); engine-on-Elmhurst-inputs 82.46 ≈ 82 → faithful. No mapper change beyond coverage.
+- [ ] 100062188801 — SAP-16.3 · eng 68 / lodged 70
+- [ ] 10008048040 — SAP-16.2 · eng 77 / lodged 75
+- [ ] 10093101966 — SAP-17.1 · eng 82 / lodged 84
+- [⚠] 10093084691 — SAP-17.1 · eng 80 / lodged 84 · 🚩 MVHR idx 500229 not credited (flagged)
+- [ ] 100061086424 — RdSAP-17.0 · eng 68 / lodged 83 · ⚠ gap -15 (review)
+- [ ] 10023443568 — SAP-17.0 · eng 84 / lodged 84
+- [ ] 100090182702 — RdSAP-17.0 · eng 55 / lodged 56
+- [⚠] 10090342180 — SAP-17.0 · eng 87 / lodged 78 · 🚩 heat-pump fuel-39 (flagged)
+- [ ] 200003398613 — SAP-16.3 · eng 80 / lodged 79
+- [ ] 10093718415 — SAP-17.1 · eng 82 / lodged 85
+- [ ] 100061850726 — RdSAP-20.0.0 · eng 77 / lodged 76
+- [⚠] 10091636031 — SAP-17.0 · eng 79 / lodged 85 · 🚩 MVHR idx 500249 not credited (flagged)
+- [⛔] 10014314830 — SAP-16.2 · NOT MAPPABLE (ValueError: RdSapSchema17_1: missing required field )
+- [⚠] 202211161 — SAP-17.0 · eng 83 / lodged 88 · 🚩 MVHR idx 500438 not credited (flagged)
+- [ ] 10094895409 — SAP-18.0.0 · eng 82 / lodged 85
+- [ ] 100060930947 — RdSAP-17.0 · eng 71 / lodged 72
+- [⚠] 10093388053 — SAP-17.1 · eng 87 / lodged 94 · 🚩 heat-pump fuel-39 (flagged)
+- [ ] 100020973465 — SAP-16.2 · eng 64 / lodged 61
+- [ ] 100062190000 — RdSAP-19.0 · eng 77 / lodged 79
+- [ ] 10093114178 — SAP-17.1 · eng 82 / lodged 84
+- [ ] 10093303593 — SAP-17.1 · eng 82 / lodged 85
+- [ ] 10093303465 — SAP-17.1 · eng 82 / lodged 84
+- [⚠] 10091194525 — SAP-17.0 · eng 82 / lodged 82 · 🚩 MVHR idx 500259 not credited (flagged)
+- [⚠] 10093386427 — SAP-17.1 · eng 79 / lodged 88 · 🚩 MVHR idx 500230 not credited (flagged)
+- [ ] 10002917849 — RdSAP-20.0.0 · eng 69 / lodged 71
+- [ ] 100020212302 — RdSAP-17.0 · eng 75 / lodged 73
+- [ ] 10012028772 — SAP-17.1 · eng 85 / lodged 83
+- [ ] 10093083532 — SAP-17.0 · eng 83 / lodged 84
+- [⚠] 10090034761 — SAP-17.0 · eng 77 / lodged 83 · 🚩 MVHR idx 500230 not credited (flagged)
+- [ ] 10070622696 — RdSAP-17.0 · eng 68 / lodged 67
+- [ ] 200003725383 — RdSAP-20.0.0 · eng 72 / lodged 73
+- [⚠] 10093387673 — SAP-17.1 · eng 81 / lodged 82 · 🚩 MVHR idx 500230 not credited (flagged)
+- [ ] 10093412389 — SAP-17.1 · eng 81 / lodged 84
+- [⚠] 10090343767 — SAP-17.0 · eng 79 / lodged 91 · 🚩 MVHR idx 500352 not credited (flagged)
+- [ ] 10090845805 — SAP-17.0 · eng 82 / lodged 87
+- [ ] 10013924858 — SAP-17.0 · eng 81 / lodged 84

.claude/skills/validate-cert-sap-accuracy/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: validate-cert-sap-accuracy
+description: Run the end-to-end loop that validates this repo's SAP calculator against accredited Elmhurst Energy for one real EPC certificate, then locks the result into the regression test corpus. Capture a cert by UPRN → generate Elmhurst inputs → (human builds it in Elmhurst) → diff the gov-API vs Elmhurst EpcPropertyData and run both through our engine → reconcile to convergence → pin the agreed SAP score in the accuracy test. Use when validating/expanding SAP-calculator accuracy against Elmhurst, adding a cert to the accuracy corpus, or when the user wants to "check a cert against Elmhurst" / "add another accuracy test".
+---
+
+# Validate cert SAP accuracy (gov-API ↔ Elmhurst)
+
+Separates **calculator** correctness from **mapper** fidelity by computing the
+same property two ways and reconciling them, then freezes the agreed score as
+a regression pin. Files land in the corpus location so the suite grows.
+
+Sample home for every cert: `backend/epc_api/json_samples/real_life_examples/<schema>/uprn_<uprn>/`
+(`epc.json`, `elmhurst_inputs.md`, `elmhurst_summary.pdf`, `elmhurst_worksheet.pdf`).
+
+## Workflow
+
+1. **Capture the cert** (gov-EPC API → saved json + our engine's score):
+   ```
+   PYTHONPATH=/workspaces/model python scripts/fetch_real_life_epc_sample.py <uprn>
+   ```
+   Writes `real_life_examples/<schema>/uprn_<uprn>/epc.json` and prints schema,
+   lodged rating, and our engine's SAP + per-end-use kWh. Note the schema:
+   only RdSAP schemas map today (full SAP `SAP-Schema-*` is partial).
+
+2. **Generate the Elmhurst input sheet** — invoke the **`epc-to-elmhurst-rdsap-inputs`**
+   skill on the UPRN. It writes `elmhurst_inputs.md` next to the json, page by
+   page, with the code→value mappings (cylinder, immersion, baths, glazing, …).
+
+3. **Human builds it in Elmhurst** from `elmhurst_inputs.md`, then exports the
+   **Summary PDF** and the **SAP-10.2 worksheet PDF**, saving them in the sample
+   dir as **`elmhurst_summary.pdf`** and **`elmhurst_worksheet.pdf`**. (This is
+   the only manual step — Elmhurst is the accredited ground truth.)
+   - **Clear the absent elements**, not just the present ones. Work the
+     `elmhurst_inputs.md` **Fields to clear (do NOT map)** section: blank every
+     phantom extension, room-in-roof, party wall, surplus window row, cylinder,
+     etc. An element left at an Elmhurst default reads as *present* and skews
+     SAP — a class of error that hides on collapsed sub-tabs (1st Ext., etc.).
+   - `scripts/hyde/elmhurst_fill.py` can drive this (Playwright): it sets and
+     **clears** fields page by page, navigating to persist (Save & Close = DB
+     commit). It is a re-keying aid; Elmhurst remains the ground truth.
+
+4. **Compare the two paths**:
+   ```
+   PYTHONPATH=/workspaces/model python scripts/compare_epc_paths.py <uprn>
+   ```
+   Builds `EpcPropertyData` from the gov-API json AND from the Elmhurst summary
+   (`parse_site_notes_pdf`), deep-diffs them, runs BOTH through `Sap10Calculator`,
+   and prints Elmhurst's own worksheet SAP (258). Reading it:
+   - **Our engine on Elmhurst inputs ≈ Elmhurst's worksheet SAP** → calculator is
+     correct (it reproduces accredited Elmhurst on identical inputs).
+   - **gov-API SAP vs Elmhurst-PDF SAP gap** → input differences only. The field
+     diff localises them.
+
+5. **Reconcile to convergence.** Triage each field diff (use the
+   `epc-to-elmhurst-rdsap-inputs` skill's `reference/mapping.md` for code
+   semantics — cylinder code 2=110 L, immersion code 1=dual, baths on the WWHRS
+   sub-tab, etc.):
+   - **Elmhurst data-entry error** (e.g. swapped floor dims, wrong cylinder/
+     immersion, missing baths, wrong postcode/region) → fix in Elmhurst, re-export,
+     re-run step 4.
+   - **gov-API mapper gap** (e.g. lodged alt-wall dropped) → a real per-cert-mapper
+     fix; flag it (Khalim's domain) — don't tune to mask it.
+   - **Genuine ground-truth question** (what the property *actually* is) → the
+     assessor/user settles it; align both sides to the lodged data.
+   Target: gov-API and a correctly-built Elmhurst within ~0.5 SAP. Cosmetic /
+   representation diffs (codes vs strings, empty `EnergyElement` lists) are noise.
+
+6. **Lock it in.** Once converged on a value you trust, add a case to
+   `tests/domain/sap10_calculator/test_real_cert_sap_accuracy.py`:
+   ```python
+   RealCertExpectation(
+       schema="<schema>", sample="uprn_<uprn>",
+       cert_num="<cert>", sap_score=<converged engine score>,
+   )
+   ```
+   with a comment recording the ground truth + what reconciled it. If a known
+   engine bug still blocks it, use `known_bug_xfail="…"` (strict xfail) instead
+   of widening. Run `pytest tests/domain/sap10_calculator/test_real_cert_sap_accuracy.py`
+   — it must pass (or xfail with the documented reason).
+
+## Notes
+
+- The sample dir IS the corpus entry — capturing + saving the PDFs there is all
+  the "expand the tests" bookkeeping needed; step 6 is what activates it.
+- `sap_score` pins the gov-API engine's integer SAP (the production path). Add
+  per-end-use kWh pins to the same `RealCertExpectation` later (worksheet-
+  validated) to tighten coverage.
+- Don't tune the mapper to a single cert — pin the observed value and fix mapper
+  gaps generically, guarded by the RdSAP-21.0.1 corpus gauge
+  (`tests/infrastructure/epc_client/test_sap_accuracy_corpus.py`).
+
+## Worked example
+
+UPRN **10002468137** (`RdSAP-Schema-17.1`): gov-API 60.92, Elmhurst 61 — converged
+after aligning dual immersion, 110 L cylinder, and 2 baths. Pinned `sap_score=61`.
+The journey closed an off-peak-water-heating bug (Table 13) and a reduced-field
+window-U bug; the calculator matched Elmhurst's cost to the penny throughout.

.devcontainer/asset_list/docker-compose.yml

@@ -1,4 +1,7 @@
 version: '3.8'
+# Unique Compose project name (see backend/docker-compose.yml) so this repo's
+# devcontainer doesn't collide with other model-* clones.
+name: landlord-asset-list
 
 services:
   model-sal:

.devcontainer/backend/Dockerfile

@@ -6,11 +6,23 @@ ARG USER_UID=1000
 ARG USER_GID=1000
 ARG DEBIAN_FRONTEND=noninteractive
 
-# 1) Toolchain + utilities for building libpostal, plus LazyVim deps
+# 1) Toolchain + utilities for building libpostal, plus LazyVim deps.
+# poppler-utils provides `pdfinfo`, required by backend/documents_parser (the
+# Elmhurst Input-Summary / SAP-worksheet PDF fixtures in the SAP corpus tests
+# shell out to it).
 RUN apt-get update && apt-get install -y --no-install-recommends \
     sudo jq vim curl git ca-certificates wget \
     build-essential pkg-config automake autoconf libtool \
-    ripgrep fd-find make unzip bash-completion \
+    ripgrep fd-find make unzip bash-completion poppler-utils \
+ && rm -rf /var/lib/apt/lists/*
+
+# 1b) Headed-browser viewer stack for the hyde Elmhurst automation.
+# scripts/hyde/start_viewer.sh chains these: Xvfb (virtual :99 screen) ->
+# fluxbox (window manager) -> x11vnc (VNC on 5900) -> novnc/websockify
+# (browser-accessible desktop on 6080). Lets a human watch/click the headed
+# Playwright browser while building certs in Elmhurst.
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    xvfb fluxbox x11vnc novnc websockify \
  && rm -rf /var/lib/apt/lists/*
 
 # Neovim latest (LazyVim needs >=0.9)
@@ -36,6 +48,13 @@ ADD etl/hubspot/requirements.txt requirements4.txt
 RUN cat requirements1.txt requirements2.txt requirements3.txt requirements4.txt > requirements.txt
 RUN pip install -r requirements.txt
 
+# Playwright OS dependencies for the hyde Elmhurst automation (scripts/hyde/).
+# The pip `playwright` package is in requirements above; this pulls the apt
+# libraries chromium needs. The browser BINARY itself is downloaded as the
+# vscode user further down (its cache lives in /home/vscode/.cache/ms-playwright,
+# which is where the automation runs from).
+RUN python -m playwright install-deps chromium
+
 # 5) Workdir
 WORKDIR /workspaces/model
 
@@ -86,4 +105,11 @@ RUN git clone https://github.com/LazyVim/starter /home/${USER}/.config/nvim \
 # Install Claude Code CLI (skills are installed via postCreate from Hestia-Homes/agentic-toolkit)
 RUN curl -fsSL https://claude.ai/install.sh | bash
 ENV PATH="/home/vscode/.local/bin:${PATH}"
+
+# Playwright chromium browser for the hyde Elmhurst automation. Run as the
+# vscode user so the download lands in /home/vscode/.cache/ms-playwright (the
+# OS deps were installed as root above). Headed chromium is required — the
+# automation launches with headless=False onto the noVNC desktop (:99).
+RUN python -m playwright install chromium
+
 USER root

.devcontainer/backend/devcontainer.json

@@ -42,11 +42,15 @@
   "containerEnv": {
     "PYTHONFLAGS": "-Xfrozen_modules=off"
   },
-  "forwardPorts": ["model-backend:8000"],
+  "forwardPorts": ["model-backend:8000", "model-backend:6080"],
   "portsAttributes": {
     "model-backend:8000": {
       "label": "FastAPI",
       "onAutoForward": "notify"
+    },
+    "model-backend:6080": {
+      "label": "hyde noVNC desktop",
+      "onAutoForward": "silent"
     }
   }
 }

.devcontainer/backend/docker-compose.yml

@@ -1,4 +1,8 @@
 version: '3.8'
+# Unique Compose project name so this repo's devcontainer doesn't collide with
+# other model-* clones (which all live in .devcontainer/backend/ and would
+# otherwise default to the same project name "backend", clobbering each other).
+name: landlord-backend
 
 services:
   model-backend:
@@ -14,6 +18,10 @@ services:
       # worktrees of this repo run at once without colliding. VS Code's
       # forwardPorts (in devcontainer.json) forwards container :8000 to your machine.
       - "8000"
+      # noVNC desktop for the hyde Elmhurst automation (scripts/hyde/start_viewer.sh).
+      # Dynamic host port like 8000; VS Code forwardPorts maps container :6080 to
+      # a stable localhost:6080 on your machine.
+      - "6080"
     volumes:
       - ../../:/workspaces/model
       - ~/.gitconfig:/home/vscode/.gitconfig:ro

.gitignore

@@ -304,6 +304,17 @@ backlog/*
 # Local Claude config files
 .claude/*modelling_cohort.csv
 .claude/settings.local.json
+.claude/settings.json
 
 # Local EPC debug cache (scripts/eon)
 scripts/eon/epc_cache.pkl
+
+# Elmhurst Playwright session (auth cookies) + captured PDFs (scripts/hyde)
+scripts/hyde/.elmhurst-session/
+scripts/hyde/elmhurst_downloads/
+scripts/hyde/.elmhurst-creds.json
+
+# Hyde property-overrides script artifacts
+overrides_cache.json
+overrides_unknowns.csv
+overrides_edits.csv

CONTEXT.md

@@ -358,6 +358,30 @@ _Avoid_: new API, current API
 The auth credential required by the New EPC API; stored in the `EPC_AUTH_TOKEN` environment variable.
 _Avoid_: API key, auth token, secret
 
+## Team
+
+Who's who on the project, so commit authorship and review history read
+correctly. The git author names below map to people as follows.
+
+**Khalim Conn-Kowlessar**:
+CTO and the technical decision-maker — the boss. Treat his calls as
+authoritative when guidance conflicts. Git author: `Khalim
+Conn-Kowlessar <kconnkowlessar@gmail.com>` (also commits as `KhalimCK`,
+same email).
+
+**Daniel Roth ("Dan")**:
+Software engineer. Git author: `Daniel Roth <daniel_roth@hotmail.co.uk>`
+(also `Daniel Roth <36244509+dancafc@users.noreply.github.com>`).
+
+**Jun-te Kim ("Junte")**:
+Software engineer. Git author: `Jun-te Kim <junte.kim@mealcraft.com>`
+(also `<juntekim@googlemail.com>` and `<39764191+kimjunte@users.noreply.github.com>`).
+
+**Michael Duong**:
+Contractor (software). Git author: `Michael Duong <michael123ster@gmail.com>`
+(also commits as `<michaelduong22@gmail.com>` and from local machine
+addresses `<michaelduong@Michaels-MacBook-Pro.local>`, `<michael@11s-MacBook.local>`).
+
 ## Relationships
 
 - A **Property** represents a single physical dwelling for modelling; identified by `(portfolio_id, UPRN)` or `(portfolio_id, landlord_property_id)`.

applications/landlord_description_overrides/handler.py

@@ -7,11 +7,16 @@ import boto3
 from applications.landlord_description_overrides.landlord_description_overrides_trigger_body import (
     LandlordDescriptionOverridesTriggerBody,
 )
-from domain.epc.built_form_type import BuiltFormType
-from domain.epc.property_type import PropertyType
-from domain.epc.roof_type import RoofType
-from domain.epc.wall_type import WallType
-from domain.epc.wall_type_construction_dates import (
+from domain.epc.property_overrides.built_form_type import BuiltFormType
+from domain.epc.property_overrides.construction_age_band import ConstructionAgeBand
+from domain.epc.property_overrides.glazing_type import GlazingType
+from domain.epc.property_overrides.main_fuel_type import MainFuelType
+from domain.epc.property_overrides.main_heating_system_type import MainHeatingSystemType
+from domain.epc.property_overrides.property_type import PropertyType
+from domain.epc.property_overrides.roof_type import RoofType
+from domain.epc.property_overrides.water_heating_type import WaterHeatingType
+from domain.epc.property_overrides.wall_type import WallType
+from domain.epc.property_overrides.wall_type_construction_dates import (
     wall_type_construction_date_prompt_hint,
 )
 from infrastructure.chatgpt.chatgpt import ChatGPT
@@ -24,6 +29,21 @@ from infrastructure.postgres.engine import commit_scope, make_engine, make_sessi
 from infrastructure.postgres.landlord_built_form_type_override_table import (
     LandlordBuiltFormTypeOverrideRow,
 )
+from infrastructure.postgres.landlord_construction_age_band_override_table import (
+    LandlordConstructionAgeBandOverrideRow,
+)
+from infrastructure.postgres.landlord_glazing_override_table import (
+    LandlordGlazingOverrideRow,
+)
+from infrastructure.postgres.landlord_main_fuel_override_table import (
+    LandlordMainFuelOverrideRow,
+)
+from infrastructure.postgres.landlord_main_heating_system_override_table import (
+    LandlordMainHeatingSystemOverrideRow,
+)
+from infrastructure.postgres.landlord_water_heating_override_table import (
+    LandlordWaterHeatingOverrideRow,
+)
 from infrastructure.postgres.landlord_property_type_override_table import (
     LandlordPropertyTypeOverrideRow,
 )
@@ -102,6 +122,56 @@ def _build_columns(
                 session, LandlordRoofTypeOverrideRow
             ),
         ),
+        "main_fuel": lambda src: ClassifiableColumn(
+            name="main_fuel",
+            source_column=src,
+            classifier=ChatGptColumnClassifier(
+                chat_gpt, MainFuelType, MainFuelType.UNKNOWN
+            ),
+            repo=LandlordOverridesRepository[MainFuelType](
+                session, LandlordMainFuelOverrideRow
+            ),
+        ),
+        "glazing": lambda src: ClassifiableColumn(
+            name="glazing",
+            source_column=src,
+            classifier=ChatGptColumnClassifier(
+                chat_gpt, GlazingType, GlazingType.UNKNOWN
+            ),
+            repo=LandlordOverridesRepository[GlazingType](
+                session, LandlordGlazingOverrideRow
+            ),
+        ),
+        "construction_age_band": lambda src: ClassifiableColumn(
+            name="construction_age_band",
+            source_column=src,
+            classifier=ChatGptColumnClassifier(
+                chat_gpt, ConstructionAgeBand, ConstructionAgeBand.UNKNOWN
+            ),
+            repo=LandlordOverridesRepository[ConstructionAgeBand](
+                session, LandlordConstructionAgeBandOverrideRow
+            ),
+        ),
+        "water_heating": lambda src: ClassifiableColumn(
+            name="water_heating",
+            source_column=src,
+            classifier=ChatGptColumnClassifier(
+                chat_gpt, WaterHeatingType, WaterHeatingType.UNKNOWN
+            ),
+            repo=LandlordOverridesRepository[WaterHeatingType](
+                session, LandlordWaterHeatingOverrideRow
+            ),
+        ),
+        "main_heating_system": lambda src: ClassifiableColumn(
+            name="main_heating_system",
+            source_column=src,
+            classifier=ChatGptColumnClassifier(
+                chat_gpt, MainHeatingSystemType, MainHeatingSystemType.UNKNOWN
+            ),
+            repo=LandlordOverridesRepository[MainHeatingSystemType](
+                session, LandlordMainHeatingSystemOverrideRow
+            ),
+        ),
     }
 
     columns: list[ClassifiableColumn[Any]] = []

backend/documents_parser/elmhurst_extractor.py

@@ -7,6 +7,7 @@ from datatypes.epc.surveys.elmhurst_site_notes import (
     BathsAndShowers,
     BuildingPartDimensions,
     CommunityHeating,
+    Conservatory,
     ElmhurstSiteNotes,
     ExtensionPart,
     FloorDetails,
@@ -30,6 +31,17 @@ from datatypes.epc.surveys.elmhurst_site_notes import (
 )
 
 
+def _parse_conservatory_storeys(raw: Optional[str]) -> float:
+    """Parse the §5 "Room Height" lodgement ("1 Storey", "1.5 Storey",
+    "1½ Storey") into the equivalent-storey count RdSAP 10 §6.1 translates
+    to a metre height. Defaults to 1.0 (single storey) when unparseable."""
+    if not raw:
+        return 1.0
+    text = raw.replace("½", ".5")
+    m = re.search(r"\d+(?:\.\d+)?", text)
+    return float(m.group(0)) if m else 1.0
+
+
 def _parse_solar_pitch_deg(raw: Optional[str]) -> Optional[int]:
     """Parse the §16.0 "Collector elevation" lodgement (e.g. "30°", "60°",
     or a bare integer). Returns None when absent or unparseable."""
@@ -81,6 +93,13 @@ class ElmhurstSiteNotesExtractor:
         except (ValueError, IndexError):
             return 0
 
+    def _float_val(self, label: str) -> Optional[float]:
+        v = self._next_val(label)
+        if not v:
+            return None
+        m = re.search(r"-?\d+(?:\.\d+)?", v)
+        return float(m.group(0)) if m else None
+
     def _date_val(self, label: str) -> date:
         v = self._next_val(label)
         if not v:
@@ -179,8 +198,39 @@ class ElmhurstSiteNotesExtractor:
         v = self._local_val(lines, label)
         return v is not None and v.lower() == "yes"
 
+    def _local_float(self, lines: List[str], label: str) -> Optional[float]:
+        v = self._local_val(lines, label)
+        if not v:
+            return None
+        m = re.search(r"-?\d+(?:\.\d+)?", v)
+        return float(m.group(0)) if m else None
+
     # --- section extractors ---
 
+    def _extract_conservatory(self) -> Optional[Conservatory]:
+        """Summary §5.0 — geometry of a conservatory (RdSAP 10 §6, PDF
+        p.49). Returns None when none is lodged. Scoped to the §5 block
+        so the generic labels ("Floor Area", "Room Height") can't collide
+        with §4 dimensions. A separated conservatory is still returned
+        (with `thermally_separated=True`); the mapper drops it per §6.2."""
+        if not self._bool_val("Is there a conservatory?"):
+            return None
+        lines = self._section_lines_first_end(
+            "5.0 Conservatory", ("7.0 Walls", "6.0 ", "Summary Information"),
+        )
+        return Conservatory(
+            thermally_separated=self._local_bool(
+                lines, "Is it thermally separated?"
+            ),
+            floor_area_m2=self._local_float(lines, "Floor Area [m2]") or 0.0,
+            double_glazed=self._local_bool(lines, "Double Glazed"),
+            glazed_perimeter_m=self._local_float(lines, "Glazed Perimeter [m]")
+            or 0.0,
+            room_height_storeys=_parse_conservatory_storeys(
+                self._local_val(lines, "Room Height")
+            ),
+        )
+
     def _extract_surveyor_info(self) -> SurveyorInfo:
         return SurveyorInfo(
             surveyor_code=self._str_val("Surveyor"),
@@ -1302,6 +1352,10 @@ class ElmhurstSiteNotesExtractor:
                 air_permeability_ap4_m3_h_m2 = float(ap4_raw.split()[0])
             except (ValueError, IndexError):
                 air_permeability_ap4_m3_h_m2 = None
+        # SAP 10.2 §2 (17) "Measured/design AP50" from a Blower Door test.
+        # Routes the cascade's (18) via `AP50 / 20 + (8)` (preferred over
+        # AP4). Absent when the test method is "Not available".
+        ap50_raw = self._local_float(pressure_lines, "Pressure Test Result (AP50)")
         # Summary §12.1 "Mechanical Ventilation Type" — scoped to §12.1
         # body so the global "Type" labels in §14 / §15 can't shadow it.
         mv_lines = self._section_lines(
@@ -1350,6 +1404,7 @@ class ElmhurstSiteNotesExtractor:
             mechanical_ventilation=self._bool_val("Mechanical Ventilation"),
             pressure_test_method=self._str_val("Test Method"),
             air_permeability_ap4_m3_h_m2=air_permeability_ap4_m3_h_m2,
+            air_permeability_ap50_m3_h_m2=ap50_raw,
             mechanical_ventilation_type=mechanical_ventilation_type,
             mechanical_ventilation_pcdf_reference=mev_pcdf_reference,
             wet_rooms_count=wet_rooms_count,
@@ -1820,6 +1875,7 @@ class ElmhurstSiteNotesExtractor:
             construction_age_band=self._extract_main_age_band(),
             dimensions=self._extract_dimensions(),
             has_conservatory=self._bool_val("Is there a conservatory?"),
+            conservatory=self._extract_conservatory(),
             walls=self._extract_walls(),
             roof=self._extract_roof(),
             floor=self._extract_floor(),

backend/ecmk_fetcher/handler/Dockerfile

@@ -1,4 +1,7 @@
-FROM mcr.microsoft.com/playwright/python:v1.58.0-jammy
+# jammy (Ubuntu 22.04) ships Python 3.10, which lacks enum.StrEnum — used by
+# domain/modelling/measure_type.py, pulled in transitively via the copied
+# domain/ package. noble (Ubuntu 24.04) ships Python 3.12.
+FROM mcr.microsoft.com/playwright/python:v1.58.0-noble
 
 # Install AWS Lambda RIE
 ADD https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie /usr/local/bin/aws-lambda-rie

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_100020212302/epc.json

@@ -0,0 +1,402 @@
+{
+  "uprn": 100020212302,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 1,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 42% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "postcode": "DA7 4NA",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "BEXLEYHEATH",
+  "built_form": 4,
+  "created_at": "2015-03-31 08:34:48.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 1,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2104,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 1,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 4017
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Mid-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Mason Close",
+  "assessment_type": "RdSAP",
+  "completion_date": "2015-03-31",
+  "inspection_date": "2015-03-30",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 103,
+  "transaction_type": 1,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "pvc_window_frames": "true",
+  "registration_date": "2015-03-31",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.41,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 34.37,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 20.96,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 6.56,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 34.37,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 20.96,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 6.56,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 2,
+          "room_height": {
+            "value": 2.42,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 34.37,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 20.96,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 6.56,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "E",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 42,
+  "solar_water_heating": "N",
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 434,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 73,
+  "lighting_cost_current": {
+    "value": 108,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer and room thermostat",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 371,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 184,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 34,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a335",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 71
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 130,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 78
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 45,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 80,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 285,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 89,
+      "environmental_impact_rating": 89
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 89,
+  "lighting_cost_potential": {
+    "value": 68,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 156,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 96
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 126,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 109,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 75
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 78,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2926,
+    "space_heating_existing_dwelling": 5282
+  },
+  "energy_consumption_current": 162,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.0.0.0",
+  "energy_consumption_potential": 51,
+  "environmental_impact_current": 71,
+  "fixed_lighting_outlets_count": 12,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 28,
+  "low_energy_fixed_lighting_outlets_count": 5
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_100060930947/epc.json

@@ -0,0 +1,325 @@
+{
+  "uprn": 100060930947,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 150 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in all fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA11 8EA",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "GRAVESEND",
+  "built_form": 2,
+  "created_at": "2015-01-16 19:39:16.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 10322
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Haldane Gardens",
+  "assessment_type": "RdSAP",
+  "completion_date": "2015-01-16",
+  "inspection_date": "2015-01-16",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 76,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "pvc_window_frames": "false",
+  "registration_date": "2015-01-16",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.35,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 38,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.6,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 17.6,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.35,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 38,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.6,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 17.6,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "F",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "150mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 422,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 72,
+  "lighting_cost_current": {
+    "value": 50,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 393,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 130,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 31,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 72
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 47,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 278,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 86,
+      "environmental_impact_rating": 85
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 86,
+  "lighting_cost_potential": {
+    "value": 50,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2629,
+    "impact_of_loft_insulation": -225,
+    "space_heating_existing_dwelling": 6203
+  },
+  "energy_consumption_current": 181,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 74,
+  "environmental_impact_current": 70,
+  "fixed_lighting_outlets_count": 9,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 32,
+  "low_energy_fixed_lighting_outlets_count": 9
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_100061086424/epc.json

@@ -0,0 +1,343 @@
+{
+  "uprn": 100061086424,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 270 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in all fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME9 9HB",
+  "hot_water": {
+    "description": {
+      "value": "Electric immersion, off-peak",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "SITTINGBOURNE",
+  "built_form": 2,
+  "created_at": "2017-01-18 22:38:36",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 4,
+    "water_heating_code": 903,
+    "water_heating_fuel": 29,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "storage_heaters": [
+          {
+            "index_number": 230001,
+            "number_of_heaters": 3,
+            "high_heat_retention": "true"
+          },
+          {
+            "index_number": 230003,
+            "number_of_heaters": 2,
+            "high_heat_retention": "true"
+          }
+        ],
+        "heat_emitter_type": 0,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2404,
+        "main_heating_category": 7,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 409,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": 1,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Electric storage heaters",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Brunswick Field",
+  "address_line_2": "Conyer",
+  "assessment_type": "RdSAP",
+  "completion_date": "2017-01-18",
+  "inspection_date": "2016-12-14",
+  "extensions_count": 1,
+  "measurement_type": 1,
+  "total_floor_area": 88,
+  "transaction_type": 5,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2017-01-18",
+  "sap_energy_source": {
+    "mains_gas": "N",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "pv_arrays": [
+        {
+          "pitch": 4,
+          "peak_power": {
+            "value": 3.1,
+            "quantity": "kW"
+          },
+          "orientation": 6,
+          "overshading": 1,
+          "pv_connection": 2
+        }
+      ]
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "Portable electric heaters (assumed)",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "lzc_energy_sources": [
+    11
+  ],
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 43.64,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 8.33,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 17.61,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 43.64,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 8.33,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 18.81,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "N",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "270mm",
+      "wall_insulation_thickness": "NI"
+    },
+    {
+      "identifier": "Extension",
+      "wall_dry_lined": "N",
+      "floor_heat_loss": 7,
+      "roof_construction": 5,
+      "wall_construction": 4,
+      "building_part_number": 2,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 1.08,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 0.9,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 2.1,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "N",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 543,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": {
+    "value": 66,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Controls for high heat retention storage heaters",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 543,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 161,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 3.4,
+  "energy_rating_potential": 83,
+  "lighting_cost_potential": {
+    "value": 66,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 161,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2170,
+    "impact_of_loft_insulation": -7,
+    "space_heating_existing_dwelling": 6598
+  },
+  "energy_consumption_current": 228,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "sap_deselected_improvements": [
+    "W2",
+    "N"
+  ],
+  "calculation_software_version": "2.0.0.0",
+  "energy_consumption_potential": 228,
+  "environmental_impact_current": 59,
+  "fixed_lighting_outlets_count": 10,
+  "windows_transmission_details": {
+    "u_value": 2,
+    "data_source": 2,
+    "solar_transmittance": 0.72
+  },
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 59,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 39,
+  "low_energy_fixed_lighting_outlets_count": 10
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_100061795739/epc.json

@@ -0,0 +1,427 @@
+{
+  "uprn": 100061795739,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 64% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "postcode": "RH11 7US",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "post_town": "CRAWLEY",
+  "built_form": 3,
+  "created_at": "2015-04-08 23:46:01.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2107,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 16513
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 2,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "End-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Vivienne Close",
+  "assessment_type": "RdSAP",
+  "completion_date": "2015-04-08",
+  "inspection_date": "2015-04-08",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 92,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "registration_date": "2015-04-08",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 275,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.35,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 46.08,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.6,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 19.2,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.35,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 46.08,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.6,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 19.2,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "F",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 64,
+  "solar_water_heating": "N",
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 566,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 65,
+  "lighting_cost_current": {
+    "value": 79,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, TRVs and bypass",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 422,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 255,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 54,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 67,
+      "environmental_impact_rating": 63
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 36,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315 - \u00a330",
+      "improvement_type": "C",
+      "improvement_details": {
+        "improvement_number": 2
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 68,
+      "environmental_impact_rating": 64
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 17,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a320",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 69,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 50,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3350 - \u00a3450",
+      "improvement_type": "G",
+      "improvement_details": {
+        "improvement_number": 14
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 68
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 144,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 45,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 78
+    },
+    {
+      "sequence": 7,
+      "typical_saving": {
+        "value": 275,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 88,
+      "environmental_impact_rating": 86
+    }
+  ],
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 88,
+  "lighting_cost_potential": {
+    "value": 58,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 156,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 95
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 127,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 78
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 122,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 72
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 75,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 3566,
+    "space_heating_existing_dwelling": 6537
+  },
+  "energy_consumption_current": 240,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 71,
+  "environmental_impact_current": 60,
+  "fixed_lighting_outlets_count": 11,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 42,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_100090182702/epc.json

@@ -0,0 +1,476 @@
+{
+  "uprn": 100090182702,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Solid brick, as built, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    },
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 33% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "postcode": "PE2 8JG",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "post_town": "PETERBOROUGH",
+  "built_form": 3,
+  "created_at": "2016-07-16 18:40:54.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 2,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 3,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 115,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 80
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "End-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Chapel Street",
+  "address_line_2": "Stanground",
+  "assessment_type": "RdSAP",
+  "completion_date": "2016-07-16",
+  "inspection_date": "2016-07-16",
+  "extensions_count": 1,
+  "measurement_type": 1,
+  "total_floor_area": 80,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "pvc_window_frames": "true",
+  "registration_date": "2016-07-16",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "Y",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.47,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 40.67,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 11.77,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 17.25,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.47,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 37.16,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 11.77,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 18.87,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "B",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "wall_insulation_thickness": "NI"
+    },
+    {
+      "identifier": "Extension",
+      "wall_dry_lined": "N",
+      "wall_thickness": 310,
+      "floor_heat_loss": 7,
+      "roof_construction": 5,
+      "wall_construction": 4,
+      "building_part_number": 2,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.47,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 2.06,
+            "quantity": "square metres"
+          },
+          "party_wall_length": 0,
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 4.08,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "I",
+      "party_wall_construction": "NA",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 33,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 780,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 4.6,
+  "energy_rating_average": 60,
+  "energy_rating_current": 56,
+  "lighting_cost_current": {
+    "value": 89,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 358,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 179,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 256,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a314,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 66,
+      "environmental_impact_rating": 63
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 49,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 68,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 29,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a340",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 70,
+      "environmental_impact_rating": 66
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 148,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 47,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 77
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 37,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a31,000 - \u00a31,400",
+      "improvement_type": "O3",
+      "improvement_details": {
+        "improvement_number": 56
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 7,
+      "typical_saving": {
+        "value": 285,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 89,
+      "environmental_impact_rating": 89
+    }
+  ],
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 89,
+  "lighting_cost_potential": {
+    "value": 53,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 154,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 95
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 105,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 77
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 119,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 71
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 71,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2579,
+    "impact_of_loft_insulation": -8,
+    "impact_of_solid_wall_insulation": -3970,
+    "space_heating_existing_dwelling": 10325
+  },
+  "energy_consumption_current": 330,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 59,
+  "environmental_impact_current": 49,
+  "fixed_lighting_outlets_count": 12,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 58,
+  "low_energy_fixed_lighting_outlets_count": 4
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_10023230742/epc.json

@@ -0,0 +1,261 @@
+{
+  "uprn": 10023230742,
+  "roofs": [
+    {
+      "description": {
+        "value": "(another dwelling above)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in all fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE8 5BU",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2015-04-30 21:43:58.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 10327
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Ground-floor flat",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "Apartment 1 The Drakes",
+  "address_line_2": "390, Evelyn Street",
+  "assessment_type": "RdSAP",
+  "completion_date": "2015-04-30",
+  "inspection_date": "2015-04-30",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 0
+  },
+  "total_floor_area": 65,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2015-04-30",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 1
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 340,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 64.8,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 16.8,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 16.8,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "K",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 210,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 81,
+  "lighting_cost_current": {
+    "value": 48,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 210,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 101,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 48,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 101,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1998,
+    "space_heating_existing_dwelling": 1652
+  },
+  "energy_consumption_current": 103,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 103,
+  "environmental_impact_current": 84,
+  "fixed_lighting_outlets_count": 8,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 84,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 18,
+  "low_energy_fixed_lighting_outlets_count": 8
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_10070622696/epc.json

@@ -0,0 +1,408 @@
+{
+  "uprn": 10070622696,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, limited insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 73% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "RH17 7GA",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "HAYWARDS HEATH",
+  "built_form": 2,
+  "created_at": "2014-12-09 15:05:29.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 101,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 2,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Old Farm Close",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-12-09",
+  "inspection_date": "2014-12-02",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 75,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "pvc_window_frames": "false",
+  "registration_date": "2014-12-09",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 320,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 39,
+            "quantity": "square metres"
+          },
+          "party_wall_length": 0,
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 20,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 36,
+            "quantity": "square metres"
+          },
+          "party_wall_length": 0,
+          "heat_loss_perimeter": {
+            "value": 19,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "I",
+      "party_wall_construction": "NI",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 73,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 452,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.0,
+  "energy_rating_average": 60,
+  "energy_rating_current": 67,
+  "lighting_cost_current": {
+    "value": 65,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 402,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 186,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 0,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 22,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315 - \u00a330",
+      "improvement_type": "C",
+      "improvement_details": {
+        "improvement_number": 2
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 68,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 13,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a380 - \u00a3120",
+      "improvement_type": "D",
+      "improvement_details": {
+        "improvement_number": 10
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 69,
+      "environmental_impact_rating": 66
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 12,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 69,
+      "environmental_impact_rating": 66
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 92,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 72
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 42,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 272,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 86,
+      "environmental_impact_rating": 85
+    }
+  ],
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 86,
+  "lighting_cost_potential": {
+    "value": 51,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 98,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 95
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 77,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 66,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 69
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 69,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 3155,
+    "space_heating_existing_dwelling": 5766
+  },
+  "energy_consumption_current": 227,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 78,
+  "environmental_impact_current": 63,
+  "fixed_lighting_outlets_count": 11,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 40,
+  "low_energy_fixed_lighting_outlets_count": 8
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.0/uprn_68151071/epc.json

@@ -0,0 +1,305 @@
+{
+  "uprn": 68151071,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 200 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Suspended, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in all fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "RH1 2BF",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "REDHILL",
+  "built_form": 2,
+  "created_at": "2017-03-29 14:14:27.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17550
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached bungalow",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 1,
+  "address_line_1": "1, Fulbourne Close",
+  "assessment_type": "RdSAP",
+  "completion_date": "2017-03-29",
+  "inspection_date": "2017-03-24",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 50,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "false",
+  "registration_date": "2017-03-29",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.36,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 50.34,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.48,
+            "quantity": "metres"
+          },
+          "floor_construction": 2,
+          "heat_loss_perimeter": {
+            "value": 20.1,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "200mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 357,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.0,
+  "energy_rating_average": 60,
+  "energy_rating_current": 70,
+  "lighting_cost_current": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 317,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 114,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 41,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W1",
+      "improvement_details": {
+        "improvement_number": 57
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 40,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 287,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 88,
+      "environmental_impact_rating": 89
+    }
+  ],
+  "co2_emissions_potential": 0.6,
+  "energy_rating_potential": 88,
+  "lighting_cost_potential": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 73,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2288,
+    "space_heating_existing_dwelling": 5169
+  },
+  "energy_consumption_current": 229,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "9.0.0",
+  "energy_consumption_potential": 68,
+  "environmental_impact_current": 70,
+  "fixed_lighting_outlets_count": 7,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 40,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.1/uprn_10002468137/elmhurst_inputs.md

@@ -0,0 +1,189 @@
+# Elmhurst RdSAP inputs — UPRN 10002468137 (cert 0215-2818-7357-9703-2145, RdSAP-Schema-17.1)
+
+**Lodged SAP:** 55  **Our engine:** 62 (continuous 62.47)  ← compare Elmhurst against **62**
+**Known divergences:**
+- **Economy-7 fuel-cost bug (see Meters / Water Heating):** the engine prices 100% of off-peak space heating + hot water at the 5.50p low rate (£0.055/kWh) instead of the SAP Table 12a high/low split. Engine total fuel cost **£595.68** vs lodged heating £619 + HW £140 + lighting £39 ≈ **£798**. This under-costing is the lead suspect for the +7 over-rating.
+- **Glazing date band (see Windows):** RdSAP-17.1 glazing codes inherit RdSAP-20.0.0 coefficients — record the U-value Elmhurst assigns vs the engine's effective 2.27 W/m²K.
+
+Property: End-terrace house, 1 Foundry Cottages, Heyshott, Midhurst GU29 0DB. All-electric, high-heat-retention storage heaters on Economy 7, solid-brick uninsulated.
+
+---
+
+## Property Description
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Property type | House | `property_type` 0 |
+| Built form | End-Terrace | `built_form` 3 |
+| Storeys | 2 | ground + first floor |
+| Habitable Rooms | 3 | `habitable_room_count` |
+| Heated Habitable Rooms | 3 | `heated_room_count` |
+| Date built — Main | **A — before 1900** | `construction_age_band` A (E&W) |
+| Extensions / Rooms in Roof | none | `extensions_count` 0; loft, not room-in-roof |
+
+## Dimensions (Type: Internal)
+
+| Floor | Floor Area [m²] | Room Height [m] | Heat Loss Perimeter [m] | Party Wall Length [m] |
+|---|---|---|---|---|
+| Lowest Floor (ground) | 24.00 | 2.40 | 12.16 | 7.06 |
+| 1st Floor | 24.00 | 2.50 | 13.86 | 7.06 |
+
+Total floor area 48 m². Heated Basement: unchecked.
+
+## Conservatory
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Is there a conservatory? | No (unchecked) | `conservatory_type` 1 = none |
+
+## Walls
+
+**External / Main wall**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | Solid Brick | `wall_construction` 3 |
+| Insulation | As Built | `wall_insulation_thickness` "NI" (none) |
+| Dry-lining | No | `wall_dry_lined` N |
+| Wall Thickness | 300 mm | `wall_thickness` 300, measured (Unknown unchecked) |
+| U-value Known | unchecked | none lodged |
+
+**Alternative Wall 1** — area 3.40 m², Solid Brick, As Built, No dry-lining, 300 mm (`sap_alternative_wall`). Alternative Wall 2: 0.00.
+
+**Party wall**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | **Solid** (U-value 0.00) | `party_wall_construction` 1 → solid masonry, U=0. **NOT "Unable to determine"** (that would wrongly add ~0.25 × area). Engine `party_walls_w_per_k` = 0.0 ✓ |
+
+## Roofs
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | PA Pitched (slates/tiles), access to loft | loft insulation |
+| Insulation | Joists | `roof_insulation_location` 2 |
+| Insulation Thickness | **200 mm** | `roof_insulation_thickness` "200mm" (default U ≈ 0.21; engine roof 5.04 W/K) |
+| U-value Known | unchecked | |
+
+## Floors
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Location | Ground floor | |
+| Type | **Solid** | `floor_construction` 1 (NOT suspended) |
+| Insulation | As built | "no insulation (assumed)" |
+| U-value Known | unchecked | engine floor 16.8 W/K |
+
+## Openings — Windows
+
+RdSAP reduced-data: **no real geometry** — synthesised as 4 windows, one per cardinal direction. Total glazing **5.75 m²** (0.148 × 48 × 0.81; `glazed_area` 3 = "less than typical", ×0.81).
+
+Add **4 identical windows**, orientations **North / East / South / West**:
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Width [m] | 1.44 | area/4 |
+| Height [m] | 1.00 | height=1 so width carries area |
+| Glazing Type | **Double with unknown install date** | `multiple_glazing_type` 3, no explicit date; engine eff U **2.27 W/m²K** — compare to Elmhurst's default (≈2.70) |
+| Frame Type | PVC | `pvc_window_frames` true |
+| Glazing Gap | 12 mm | `glazing_gap` 12 |
+| Location | **External wall** | not Alternative wall |
+| Orientation | N / E / S / W (one each) | not lodged; engine spreads evenly |
+| Draught Proofed | ✓ (100%) | `percent_draughtproofed` 100 |
+| U-value / g-value | leave Elmhurst default | note for comparison |
+
+## Openings — Doors
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Total Number of Doors | 2 | `door_count` |
+| Number of Insulated Doors | 0 | `insulated_door_count` |
+| Number of Draught Proofed Doors | 2 | 100% draughtproofed |
+
+(Engine doors 11.1 W/K = 2 × 1.85 m² × 3.0 default U ✓)
+
+## Ventilation & Lighting
+
+**Ventilation** — all 0 / unchecked: open chimneys 0 (`open_fireplaces_count`), no flues/passive vents/flueless gas fires; Fixed space cooling unchecked (`has_fixed_air_conditioning` false). Draught Lobby: leave default (not in RdSAP house data).
+
+**Mechanical Ventilation** — unchecked (`mechanical_ventilation` 0 = natural).
+
+**Air Pressure Test** — Not available (RdSAP uses % draughtproofing).
+
+**Lighting**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Total number of bulbs | 6 | `fixed_lighting_outlets_count` (SAP-2012 lodges outlets, not bulbs) |
+| Low energy | 6 (100%) | `low_energy_fixed_lighting_outlets_count`; minor energy term (engine 133 kWh) |
+| Incandescents | 0 | |
+
+## Space Heating
+
+**Main Heating 1**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Main Heating EES Code | **SEK → SAP 409, High heat retention storage heaters** | EES: Electric → Electric → Storage → High heat retention. `sap_main_heating_code` 409 |
+| Main Heating Controls EES | **CSD → SAP 2404, Controls for high heat retention storage heaters** | EES: Storage Radiator Systems → CSD. `main_heating_control` 2404 |
+| Percentage of Heat | 100 | `main_heating_fraction` 1 |
+| Storage heater list | 6 heaters, all high heat retention | `storage_heaters` 2+2+2 |
+| PCDF refs / Compensator | 0 | none lodged |
+| Heat Emitter / Flue / Pump Age | N/A | wet-system fields — disabled for storage heaters |
+
+**Main Heating 2** — none (clear "COM"; % heat 0). Only one main system.
+
+**Community Heating** — None.
+
+**Meters** ⚠️
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Electricity meter type | **Dual-rate / Economy 7 (7-hour)** | NOT Single. `main_fuel_type`/`water_heating_fuel` 29 = off-peak 7-hour. **Engine bug: prices 100% at 5.50p low rate (£0.055/kWh) — should apply SAP Table 12a high/low split (high rate 15.29p)** |
+| Mains gas | **unchecked** | `mains_gas` N |
+| Electricity / Gas Smart Meter | unchecked | |
+
+**Secondary heating**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Is there secondary heating? | Yes | engine 10% fraction |
+| Secondary Heating EES Code | REA → SAP 691, Electric Panel/convector/radiant heaters | "Portable electric heaters (assumed)"; EES Electric → Electric → Room Heaters → Panel/convector/radiant. **Standard** tariff (fuel 30, 15.29p) — engine got this rate right |
+
+## Water Heating
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Water Heating EES Code | **SAP 903, Electric immersion (off-peak)** | Elmhurst "**Water Heater**" category — NOT "Boiler Circulator" (901 = from main system). `water_heating_code` 903 |
+| Hot Water Cylinder Present | ✓ checked | `has_hot_water_cylinder` true |
+| Cylinder Size | Medium | `cylinder_size` 2 |
+| Insulated | **Foam** | `cylinder_insulation_type` 1 = factory foam |
+| Insulation Thickness | 38 mm | `cylinder_insulation_thickness` |
+| Immersion Heater | Single | `immersion_heating_type` 1 |
+
+(HW also priced at the buggy £0.055/kWh — engine HW 2134 kWh.)
+
+- **Community Hot Water** — PCDF ref 0 (none).
+- **Solar Water Heating** — unchecked (`solar_water_heating` N).
+- **WWHRS** ⚠️ — **No / not present**. `sap_heating.instantaneous_wwhrs` here = bath/shower ROOM counts (1 bath/shower room + 1 bath-with-mixer), NOT a heat-recovery device (ADR-0028). Do **not** add a Showersave unit — it would wrongly raise the score.
+- **FGHRS** — both unchecked (`has_fghrs` N).
+
+## New Technologies
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Photovoltaic panel | None | no PV lodged |
+| Wind turbine present? | No | `wind_turbines_count` 0 |
+| Small-Scale Hydro | 0.00 | |
+| Special Features (Appendix Q) | none | |
+
+(Export capable meter has no effect with no generation.)
+
+---
+
+## Engine reference values (for cross-check)
+
+| Quantity | Engine value |
+|---|---|
+| SAP score | **62** (continuous 62.47) |
+| Total fuel cost | £595.68 |
+| Space heating | 6717.47 kWh/yr (main fuel 6045.73, secondary 671.75) |
+| Hot water | 2134.0 kWh/yr |
+| Lighting | 133.35 kWh/yr |
+| Heat loss (total) | 144.28 W/K — walls 80.98, roof 5.04, floor 16.80, windows 13.07 (eff U 2.27), doors 11.10, party wall 0.0, thermal bridging 17.30 |
+| Space heating / HW fuel | £0.055/kWh (off-peak low rate — **see bug note**) |
+
+**Next step:** key these into Elmhurst, then read off Elmhurst's SAP score. If it lands near **55** (lodged) rather than our **62**, the Economy-7 fuel-cost split is confirmed as the over-rating cause.

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.1/uprn_10002468137/epc.json

@@ -0,0 +1,349 @@
+{
+  "uprn": 10002468137,
+  "roofs": [
+    {
+      "description": "Pitched, 200 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Solid brick, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "GU29 0DB",
+  "hot_water": {
+    "description": "Electric immersion, off-peak",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "MIDHURST",
+  "built_form": 3,
+  "created_at": "2017-05-29 21:33:44.000000",
+  "door_count": 2,
+  "glazed_area": 3,
+  "glazing_gap": 12,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 903,
+    "water_heating_fuel": 29,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "storage_heaters": [
+          {
+            "index_number": 230013,
+            "number_of_heaters": 2,
+            "high_heat_retention": "true"
+          },
+          {
+            "index_number": 230001,
+            "number_of_heaters": 2,
+            "high_heat_retention": "true"
+          },
+          {
+            "index_number": 230002,
+            "number_of_heaters": 2,
+            "high_heat_retention": "true"
+          }
+        ],
+        "heat_emitter_type": 0,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2404,
+        "main_heating_category": 7,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 409,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": 1,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Electric storage heaters",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1 Foundry Cottages",
+  "address_line_2": "Heyshott",
+  "assessment_type": "RdSAP",
+  "completion_date": "2017-05-29",
+  "inspection_date": "2017-05-08",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 48,
+  "transaction_type": 5,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "true",
+  "registration_date": "2017-05-29",
+  "sap_energy_source": {
+    "mains_gas": "N",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "Portable electric heaters (assumed)",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 3.4,
+        "wall_dry_lined": "N",
+        "wall_thickness": 300,
+        "wall_construction": 3,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y",
+        "wall_insulation_thickness": "NI"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 24,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.06,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 12.16,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.5,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 24,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.06,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 13.86,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "A",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "200mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 619,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 4.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 55,
+  "lighting_cost_current": {
+    "value": 39,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Controls for high heat retention storage heaters",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 253,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 140,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 309,
+        "currency": "GBP"
+      },
+      "indicative_cost": "14,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 54
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 39,
+        "currency": "GBP"
+      },
+      "indicative_cost": "6,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 58
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 63,
+        "currency": "GBP"
+      },
+      "indicative_cost": "6,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 64
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 20,
+        "currency": "GBP"
+      },
+      "indicative_cost": "1,000",
+      "improvement_type": "X",
+      "improvement_details": {
+        "improvement_number": 48
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 66
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 318,
+        "currency": "GBP"
+      },
+      "indicative_cost": "8,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 93,
+      "environmental_impact_rating": 78
+    }
+  ],
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 93,
+  "lighting_cost_potential": {
+    "value": 39,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.1",
+  "hot_water_cost_potential": {
+    "value": 74,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1657,
+    "impact_of_solid_wall_insulation": -3811,
+    "space_heating_existing_dwelling": 7524
+  },
+  "energy_consumption_current": 602,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.11r11",
+  "energy_consumption_potential": 136,
+  "environmental_impact_current": 33,
+  "fixed_lighting_outlets_count": 6,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 78,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "A",
+  "co2_emissions_current_per_floor_area": 102,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-17.1/uprn_10010215568/epc.json

@@ -0,0 +1,290 @@
+{
+  "uprn": 10010215568,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 200 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 86% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE3 8AH",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2017-06-13 23:05:44.000000",
+  "door_count": 3,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "mcs_installed_heat_pump": "false",
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 15100
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.92,
+  "schema_type": "RdSAP-Schema-17.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "End-terrace bungalow",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 1,
+  "address_line_1": "1, Annesmere Gardens",
+  "assessment_type": "RdSAP",
+  "completion_date": "2017-06-13",
+  "inspection_date": "2017-06-13",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 75,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2017-06-13",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 310,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.45,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 75.46,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.8,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 25.2,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "J",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "200mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 86,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 334,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.1,
+  "energy_rating_average": 60,
+  "energy_rating_current": 74,
+  "lighting_cost_current": {
+    "value": 63,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 338,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 127,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 50,
+        "currency": "GBP"
+      },
+      "indicative_cost": "6,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 77
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 281,
+        "currency": "GBP"
+      },
+      "indicative_cost": "8,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 87,
+      "environmental_impact_rating": 87
+    }
+  ],
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 87,
+  "lighting_cost_potential": {
+    "value": 63,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 73,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2544,
+    "space_heating_existing_dwelling": 4657
+  },
+  "energy_consumption_current": 156,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "1.0.x",
+  "energy_consumption_potential": 62,
+  "environmental_impact_current": 74,
+  "fixed_lighting_outlets_count": 7,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 87,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 27,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-18.0/uprn_100020450179/epc.json

@@ -0,0 +1,293 @@
+{
+  "uprn": 100020450179,
+  "roofs": [
+    {
+      "description": "Pitched, 200 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, filled cavity",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": "Low energy lighting in 78% of fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "BR5 2TD",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "ORPINGTON",
+  "built_form": 2,
+  "created_at": "2018-10-08 14:02:11.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "glazing_gap": "16+",
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17505
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.93,
+  "schema_type": "RdSAP-Schema-18.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "20, Brenchley Road",
+  "assessment_type": "RdSAP",
+  "completion_date": "2018-10-08",
+  "inspection_date": "2018-10-05",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 73,
+  "transaction_type": 8,
+  "conservatory_type": 2,
+  "heated_room_count": 5,
+  "pvc_window_frames": "true",
+  "registration_date": "2018-10-08",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.5,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 36.55,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 6.48,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 17.76,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.43,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 36.55,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 6.48,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 17.76,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "D",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "200mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 78,
+  "solar_water_heating": "N",
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 396,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.3,
+  "energy_rating_average": 60,
+  "energy_rating_current": 73,
+  "lighting_cost_current": {
+    "value": 65,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 367,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 83,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 29,
+        "currency": "GBP"
+      },
+      "indicative_cost": "6,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 29,
+        "currency": "GBP"
+      },
+      "indicative_cost": "6,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 305,
+        "currency": "GBP"
+      },
+      "indicative_cost": "8,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 87,
+      "environmental_impact_rating": 86
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 87,
+  "lighting_cost_potential": {
+    "value": 65,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-18.0",
+  "hot_water_cost_potential": {
+    "value": 54,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1866,
+    "space_heating_existing_dwelling": 6466
+  },
+  "energy_consumption_current": 178,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "3.08r07",
+  "energy_consumption_potential": 75,
+  "environmental_impact_current": 71,
+  "fixed_lighting_outlets_count": 9,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 31,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-18.0/uprn_10022893721/epc.json

@@ -0,0 +1,310 @@
+{
+  "uprn": 10022893721,
+  "roofs": [
+    {
+      "description": {
+        "value": "(another dwelling above)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, limited insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in all fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME14 5HQ",
+  "hot_water": {
+    "description": {
+      "value": "Electric immersion, off-peak",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 3,
+  "created_at": "2018-02-22 15:20:43.000000",
+  "door_count": 0,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 903,
+    "water_heating_fuel": 29,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "heat_emitter_type": 0,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2401,
+        "main_heating_category": 7,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 402,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": 1,
+    "secondary_heating_type": 691,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.93,
+  "schema_type": "RdSAP-Schema-18.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Electric storage heaters",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "dwelling_type": {
+    "value": "Ground-floor flat",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1 Crystal House",
+  "address_line_2": "Coral Park",
+  "assessment_type": "RdSAP",
+  "completion_date": "2018-02-22",
+  "inspection_date": "2018-02-22",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 1
+  },
+  "total_floor_area": 54,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "false",
+  "registration_date": "2018-02-22",
+  "sap_energy_source": {
+    "mains_gas": "N",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "Room heaters, electric",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 330,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.27,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 54.29,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 21.48,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 8.69,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "I",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 204,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 79,
+  "lighting_cost_current": {
+    "value": 49,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Manual charge control",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 161,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 144,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 42,
+        "currency": "GBP"
+      },
+      "indicative_cost": "1,800",
+      "improvement_type": "L2",
+      "improvement_details": {
+        "improvement_number": 60
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 71
+    }
+  ],
+  "co2_emissions_potential": 2.0,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 49,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-18.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 88,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 83,
+      "environmental_impact_rating": 95
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 67,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 83,
+      "environmental_impact_rating": 85
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 144,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1658,
+    "space_heating_existing_dwelling": 2212
+  },
+  "energy_consumption_current": 234,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.0.x",
+  "energy_consumption_potential": 214,
+  "environmental_impact_current": 69,
+  "fixed_lighting_outlets_count": 6,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 71,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 40,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-19.0/uprn_100062190000/epc.json

@@ -0,0 +1,284 @@
+{
+  "uprn": 100062190000,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, partial insulation (assumed)",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    },
+    {
+      "description": "Solid brick, as built, partial insulation (assumed)",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "floors": [
+    {
+      "description": "(another dwelling below)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 1,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "addendum": {
+    "cavity_fill_recommended": "true"
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "RH11 8AZ",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "CRAWLEY",
+  "built_form": 6,
+  "created_at": "2020-09-10 17:27:19.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "glazing_gap": "16+",
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 10242
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-19.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "Flat 10 Helicon House",
+  "address_line_2": "Oak Road",
+  "assessment_type": "RdSAP",
+  "completion_date": "2020-09-10",
+  "inspection_date": "2020-09-09",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 2,
+    "top_storey": "N",
+    "flat_location": 1,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": 10.83
+  },
+  "total_floor_area": 71,
+  "transaction_type": 1,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "true",
+  "registration_date": "2020-09-10",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 6,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 25.5588,
+        "sheltered_wall": "Y",
+        "wall_dry_lined": "N",
+        "wall_thickness": 270,
+        "wall_construction": 3,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y",
+        "wall_insulation_thickness": "NI"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.36,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 70.6,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 10.83,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 24.47,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "F",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 266,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.6,
+  "energy_rating_average": 60,
+  "energy_rating_current": 79,
+  "lighting_cost_current": {
+    "value": 62,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 211,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 95,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 30,
+        "currency": "GBP"
+      },
+      "indicative_cost": "1,500",
+      "improvement_type": "B",
+      "improvement_details": {
+        "improvement_number": 6
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 83
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 24,
+        "currency": "GBP"
+      },
+      "indicative_cost": "14,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 82,
+      "environmental_impact_rating": 85
+    }
+  ],
+  "co2_emissions_potential": 1.3,
+  "energy_rating_potential": 82,
+  "lighting_cost_potential": {
+    "value": 62,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 95,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2124,
+    "impact_of_cavity_insulation": -697,
+    "impact_of_solid_wall_insulation": -559,
+    "space_heating_existing_dwelling": 3289
+  },
+  "energy_consumption_current": 126,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "4.05r0005",
+  "energy_consumption_potential": 102,
+  "environmental_impact_current": 81,
+  "fixed_lighting_outlets_count": 5,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 22,
+  "low_energy_fixed_lighting_outlets_count": 5
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-19.0/uprn_10009432998/epc.json

@@ -0,0 +1,278 @@
+{
+  "uprn": 10009432998,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Timber frame, as built, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "To unheated space, insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 80% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 5GN",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "built_form": 4,
+  "created_at": "2019-10-15 00:54:08.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "N",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "mcs_installed_heat_pump": "false",
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 9901
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-19.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Top-floor flat",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1 Thorpe Court",
+  "address_line_2": "Cameron Drive",
+  "assessment_type": "RdSAP",
+  "completion_date": "2019-10-14",
+  "inspection_date": "2019-10-14",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 3,
+    "top_storey": "Y",
+    "flat_location": 1,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": {
+      "value": 4.2,
+      "quantity": "metres"
+    }
+  },
+  "total_floor_area": 44,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 2,
+  "pvc_window_frames": "false",
+  "registration_date": "2019-10-14",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 260,
+      "floor_heat_loss": 2,
+      "roof_construction": 5,
+      "wall_construction": 5,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 10.206,
+        "sheltered_wall": "Y",
+        "wall_dry_lined": "N",
+        "wall_thickness": 300,
+        "wall_construction": 5,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y",
+        "wall_insulation_thickness": "NI"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.43,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 44.02,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.75,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 19.11,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "K",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 80,
+  "solar_water_heating": "N",
+  "habitable_room_count": 2,
+  "heating_cost_current": {
+    "value": 208,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.1,
+  "energy_rating_average": 60,
+  "energy_rating_current": 78,
+  "lighting_cost_current": {
+    "value": 48,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 208,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 75,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 78,
+  "lighting_cost_potential": {
+    "value": 48,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 75,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1606,
+    "space_heating_existing_dwelling": 2087
+  },
+  "energy_consumption_current": 148,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "v94.0.1.1",
+  "energy_consumption_potential": 148,
+  "environmental_impact_current": 81,
+  "fixed_lighting_outlets_count": 5,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 81,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 26,
+  "low_energy_fixed_lighting_outlets_count": 4
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_100020665611/epc.json

@@ -0,0 +1,406 @@
+{
+  "uprn": 100020665611,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, limited insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, as built, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "addendum": {
+    "cavity_fill_recommended": "true"
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 91% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "CR8 2NT",
+  "hot_water": {
+    "description": {
+      "value": "Electric immersion, off-peak",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "PURLEY",
+  "built_form": 3,
+  "created_at": "2021-08-31 18:37:00.948430",
+  "door_count": 1,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 903,
+    "water_heating_fuel": 29,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "heat_emitter_type": 0,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2401,
+        "main_heating_category": 7,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 402,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": 1,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Electric storage heaters",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "dwelling_type": {
+    "value": "end-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1 Gilliam Grove",
+  "assessment_type": "RdSAP",
+  "completion_date": "2021-08-31",
+  "inspection_date": "2021-08-24",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 87,
+  "transaction_type": 13,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "pvc_window_frames": "true",
+  "registration_date": "2021-08-31",
+  "sap_energy_source": {
+    "mains_gas": "N",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "Portable electric heaters (assumed)",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 260,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 43.7,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.5,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 18.7,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 43.7,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.5,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 18.7,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "E",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 91,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 1715,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 9.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 37,
+  "lighting_cost_current": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Manual charge control",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 950,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 227,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 340,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3500 - \u00a31,500",
+      "improvement_type": "B",
+      "improvement_details": {
+        "improvement_number": 6
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 46,
+      "environmental_impact_rating": 28
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 99,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 49,
+      "environmental_impact_rating": 30
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 330,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a31,600 - \u00a32,400",
+      "improvement_type": "L2",
+      "improvement_details": {
+        "improvement_number": 60
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 60,
+      "environmental_impact_rating": 38
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 97,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 63,
+      "environmental_impact_rating": 41
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 372,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 48
+    }
+  ],
+  "co2_emissions_potential": 4.6,
+  "energy_rating_potential": 73,
+  "lighting_cost_potential": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 174,
+        "currency": "GBP"
+      },
+      "improvement_type": "Q2",
+      "improvement_details": {
+        "improvement_number": 55
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 52,
+      "environmental_impact_rating": 32
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 739,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 66,
+      "environmental_impact_rating": 94
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 564,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 63,
+      "environmental_impact_rating": 68
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 126,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2033,
+    "impact_of_loft_insulation": -3064,
+    "impact_of_cavity_insulation": -3220,
+    "space_heating_existing_dwelling": 15721
+  },
+  "energy_consumption_current": 638,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.0.1",
+  "energy_consumption_potential": 313,
+  "environmental_impact_current": 20,
+  "fixed_lighting_outlets_count": 11,
+  "windows_transmission_details": {
+    "u_value": 2.8,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "F",
+  "environmental_impact_potential": 48,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 108,
+  "low_energy_fixed_lighting_outlets_count": 10
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_100020937013/epc.json

@@ -0,0 +1,348 @@
+{
+  "uprn": 100020937013,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 150 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Suspended, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 71% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE18 6EQ",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2022-05-09 13:31:05.170211",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17823
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 691,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "end-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10 Ashlar Place",
+  "assessment_type": "RdSAP",
+  "completion_date": "2022-05-09",
+  "inspection_date": "2021-10-05",
+  "extensions_count": 0,
+  "measurement_type": 2,
+  "total_floor_area": 99,
+  "transaction_type": 13,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "pvc_window_frames": "false",
+  "registration_date": "2022-05-09",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_u_value": 0.33,
+      "wall_dry_lined": "N",
+      "wall_thickness": 270,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 59.03,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.43,
+            "quantity": "metres"
+          },
+          "floor_construction": 2,
+          "heat_loss_perimeter": {
+            "value": 23.93,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 54.2,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 9.43,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 20.93,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "H",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "150mm",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 71,
+  "solar_water_heating": "N",
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 444,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 73,
+  "lighting_cost_current": {
+    "value": 103,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 408,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 118,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 39,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W1",
+      "improvement_details": {
+        "improvement_number": 57
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 72
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 21,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a310",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 38,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 347,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 83
+    }
+  ],
+  "co2_emissions_potential": 1.4,
+  "energy_rating_potential": 85,
+  "lighting_cost_potential": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 79,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2695,
+    "impact_of_loft_insulation": -304,
+    "space_heating_existing_dwelling": 7678
+  },
+  "energy_consumption_current": 165,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.1.0",
+  "energy_consumption_potential": 79,
+  "environmental_impact_current": 70,
+  "fixed_lighting_outlets_count": 7,
+  "windows_transmission_details": {
+    "u_value": 3.1,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 83,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 29,
+  "low_energy_fixed_lighting_outlets_count": 5
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_10002917849/epc.json

@@ -0,0 +1,366 @@
+{
+  "uprn": 10002917849,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Suspended, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 83% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME6 5GW",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "SNODLAND",
+  "built_form": 2,
+  "created_at": "2022-03-30 13:30:35.278971",
+  "door_count": 2,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 4,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 101,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 691,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10 MARY LAST CLOSE",
+  "assessment_type": "RdSAP",
+  "completion_date": "2022-03-30",
+  "inspection_date": "2021-06-22",
+  "extensions_count": 0,
+  "measurement_type": 2,
+  "total_floor_area": 141,
+  "transaction_type": 9,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "true",
+  "registration_date": "2022-03-30",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_u_value": 0.33,
+      "wall_dry_lined": "N",
+      "wall_thickness": 310,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 80,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 10,
+            "quantity": "metres"
+          },
+          "floor_construction": 2,
+          "heat_loss_perimeter": {
+            "value": 26,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 80,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 10,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 26,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "G",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 83,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 649,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 4.3,
+  "energy_rating_average": 60,
+  "energy_rating_current": 71,
+  "lighting_cost_current": {
+    "value": 111,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 520,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 166,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 62,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W1",
+      "improvement_details": {
+        "improvement_number": 57
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 69
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 111,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 46,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 361,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 82
+    }
+  ],
+  "co2_emissions_potential": 2.0,
+  "energy_rating_potential": 85,
+  "lighting_cost_potential": {
+    "value": 111,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "alternative_improvements": [
+    {
+      "improvement": {
+        "sequence": 1,
+        "typical_saving": {
+          "value": 174,
+          "currency": "GBP"
+        },
+        "improvement_type": "Z3",
+        "improvement_details": {
+          "improvement_number": 53
+        },
+        "improvement_category": 6,
+        "energy_performance_rating": 77,
+        "environmental_impact_rating": 73
+      }
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 75,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2971,
+    "space_heating_existing_dwelling": 10194
+  },
+  "energy_consumption_current": 171,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.1.0",
+  "energy_consumption_potential": 79,
+  "environmental_impact_current": 66,
+  "fixed_lighting_outlets_count": 12,
+  "windows_transmission_details": {
+    "u_value": 2.8,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 82,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 30,
+  "low_energy_fixed_lighting_outlets_count": 10
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_100061850726/epc.json

@@ -0,0 +1,281 @@
+{
+  "uprn": 100061850726,
+  "roofs": [
+    {
+      "description": "Pitched, 150 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "RH19 2SD",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "EAST GRINSTEAD",
+  "built_form": 4,
+  "created_at": "2025-03-21 12:41:54",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 18400
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10 Dorset Gardens",
+  "address_line_2": "Dorset Avenue",
+  "assessment_type": "RdSAP",
+  "completion_date": "2025-03-21",
+  "inspection_date": "2025-03-21",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 57,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2025-03-21",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.33,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 28.3,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 15.68,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 7.22,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.31,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 28.3,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 15.68,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 7.22,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "150mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 362,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.6,
+  "energy_rating_average": 60,
+  "energy_rating_current": 76,
+  "lighting_cost_current": {
+    "value": 63,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 365,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 165,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 58,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 448,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 91,
+      "environmental_impact_rating": 93
+    }
+  ],
+  "co2_emissions_potential": 0.4,
+  "energy_rating_potential": 91,
+  "lighting_cost_potential": {
+    "value": 63,
+    "currency": "GBP"
+  },
+  "schema_version_original": "20.0.0",
+  "hot_water_cost_potential": {
+    "value": 103,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2433,
+    "impact_of_loft_insulation": -198,
+    "space_heating_existing_dwelling": 3291
+  },
+  "energy_consumption_current": 163,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "4.13r0002",
+  "energy_consumption_potential": 39,
+  "environmental_impact_current": 78,
+  "fixed_lighting_outlets_count": 9,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 93,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 29,
+  "low_energy_fixed_lighting_outlets_count": 9
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_100090108846/epc.json

@@ -0,0 +1,417 @@
+{
+  "uprn": 100090108846,
+  "roofs": [
+    {
+      "description": "Pitched, 270 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "addendum": {
+    "addendum_numbers": [
+      8
+    ]
+  },
+  "lighting": {
+    "description": "Low energy lighting in 70% of fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "PE28 0HD",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 1,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "HUNTINGDON",
+  "built_form": 2,
+  "created_at": "2023-05-24 20:40:31",
+  "door_count": 1,
+  "glazed_area": 4,
+  "region_code": 2,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 3,
+    "water_heating_code": 901,
+    "water_heating_fuel": 29,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "main_heating_number": 1,
+        "main_heating_control": 2207,
+        "main_heating_category": 4,
+        "main_heating_fraction": 1,
+        "mcs_installed_heat_pump": "true",
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 102431
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.94,
+  "sap_windows": [
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 2,
+      "window_area": {
+        "value": 1,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 2,
+      "window_area": {
+        "value": 0.3,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 2,
+      "window_area": {
+        "value": 1.5,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 2,
+      "window_area": {
+        "value": 1,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 6,
+      "window_area": {
+        "value": 4,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 6,
+      "window_area": {
+        "value": 0.9,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 6,
+      "window_area": {
+        "value": 2.8,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 4,
+      "window_area": {
+        "value": 1.3,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 4,
+      "window_area": {
+        "value": 1.5,
+        "quantity": "square metres"
+      },
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_location": 0
+    }
+  ],
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Air source heat pump, radiators, electric",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1 Maurice Close",
+  "address_line_2": "Kimbolton",
+  "assessment_type": "RdSAP",
+  "completion_date": "2023-05-24",
+  "inspection_date": "2023-05-24",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 87,
+  "transaction_type": 9,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2023-05-24",
+  "sap_energy_source": {
+    "mains_gas": "N",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "pv_arrays": [
+        {
+          "pitch": 2,
+          "peak_power": 3,
+          "orientation": 4,
+          "overshading": 1,
+          "pv_connection": 2
+        }
+      ]
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "lzc_energy_sources": [
+    9,
+    11
+  ],
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.43,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 43.4,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 4.73,
+            "quantity": "metres"
+          },
+          "floor_construction": 3,
+          "heat_loss_perimeter": {
+            "value": 23.01,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 43.4,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 4.73,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 23.01,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "G",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "270mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 70,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 1117,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.6,
+  "energy_rating_average": 60,
+  "energy_rating_current": 79,
+  "lighting_cost_current": {
+    "value": 194,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "multiple_glazing_type": "ND",
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 974,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 891,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 154,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W1",
+      "improvement_details": {
+        "improvement_number": 57
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 84
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 38,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 82,
+      "environmental_impact_rating": 84
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 300,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 86,
+      "environmental_impact_rating": 88
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 86,
+  "lighting_cost_potential": {
+    "value": 150,
+    "currency": "GBP"
+  },
+  "schema_version_original": "20.0.0",
+  "hot_water_cost_potential": {
+    "value": 588,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2741,
+    "space_heating_existing_dwelling": 9770
+  },
+  "energy_consumption_current": 111,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "4.11r0005",
+  "energy_consumption_potential": 65,
+  "environmental_impact_current": 81,
+  "fixed_lighting_outlets_count": 10,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 88,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 19,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_10090844932/epc.json

@@ -0,0 +1,277 @@
+{
+  "uprn": 10090844932,
+  "roofs": [
+    {
+      "description": "Pitched, 250 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, insulated (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 1,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SO23 7GL",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "WINCHESTER",
+  "built_form": 3,
+  "created_at": "2021-08-05 08:15:22.041089",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 16,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 10327
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1 BLACKBERRY FIELD",
+  "address_line_2": "KINGS WORTHY",
+  "assessment_type": "RdSAP",
+  "completion_date": "2021-08-05",
+  "inspection_date": "2021-08-04",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 75,
+  "transaction_type": 1,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2021-08-05",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 370,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 37.37,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 4.93,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 20.09,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.4,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 37.37,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 4.93,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 20.09,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "L",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 280,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 78,
+  "lighting_cost_current": {
+    "value": 67,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 280,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 93,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 29,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 364,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 91,
+      "environmental_impact_rating": 91
+    }
+  ],
+  "co2_emissions_potential": 0.5,
+  "energy_rating_potential": 91,
+  "lighting_cost_potential": {
+    "value": 67,
+    "currency": "GBP"
+  },
+  "schema_version_original": "20.0.0",
+  "hot_water_cost_potential": {
+    "value": 64,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2093,
+    "space_heating_existing_dwelling": 3707
+  },
+  "energy_consumption_current": 129,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "4.07r0002",
+  "energy_consumption_potential": 36,
+  "environmental_impact_current": 79,
+  "fixed_lighting_outlets_count": 12,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 91,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 23,
+  "low_energy_fixed_lighting_outlets_count": 12
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_200003714056/epc.json

@@ -0,0 +1,314 @@
+{
+  "uprn": 200003714056,
+  "roofs": [
+    {
+      "description": {
+        "value": "(another dwelling above)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 75% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME15 7RW",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 1,
+  "created_at": "2022-04-14 15:12:29.112725",
+  "door_count": 1,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17505
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 691,
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Ground-floor flat",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "FLAT 1",
+  "address_line_2": "LAVENDER HOUSE",
+  "address_line_3": "NORTHUMBERLAND ROAD",
+  "assessment_type": "RdSAP",
+  "completion_date": "2022-04-14",
+  "inspection_date": "2021-09-07",
+  "extensions_count": 0,
+  "measurement_type": 2,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": {
+      "value": 6,
+      "quantity": "metres"
+    }
+  },
+  "total_floor_area": 61,
+  "transaction_type": 13,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "true",
+  "registration_date": "2022-04-14",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_u_value": 0.33,
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 16.5,
+        "wall_u_value": 0.33,
+        "sheltered_wall": "Y",
+        "wall_dry_lined": "N",
+        "wall_construction": 4,
+        "wall_insulation_type": 2,
+        "wall_thickness_measured": "N"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 70,
+            "quantity": "square metres"
+          },
+          "party_wall_length": 0,
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 34,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "G",
+      "party_wall_construction": "NA",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 75,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 333,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 74,
+  "lighting_cost_current": {
+    "value": 72,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 274,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 73,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 60,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 80
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 13,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a310",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 80
+    }
+  ],
+  "co2_emissions_potential": 1.5,
+  "energy_rating_potential": 78,
+  "lighting_cost_potential": {
+    "value": 58,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 74,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1742,
+    "space_heating_existing_dwelling": 5021
+  },
+  "energy_consumption_current": 178,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.1.0",
+  "energy_consumption_potential": 143,
+  "environmental_impact_current": 75,
+  "fixed_lighting_outlets_count": 8,
+  "windows_transmission_details": {
+    "u_value": 2.8,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 80,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 31,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_200003725383/epc.json

@@ -0,0 +1,348 @@
+{
+  "uprn": 200003725383,
+  "roofs": [
+    {
+      "description": {
+        "value": "Pitched, 250 mm loft insulation",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Suspended, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 75% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME15 7SZ",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 4,
+  "created_at": "2022-04-13 20:24:23.023351",
+  "door_count": 1,
+  "glazed_area": 1,
+  "glazing_gap": 12,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 102,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 691,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Mid-terrace house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10 OWLETTS CLOSE",
+  "assessment_type": "RdSAP",
+  "completion_date": "2022-04-13",
+  "inspection_date": "2021-09-08",
+  "extensions_count": 0,
+  "measurement_type": 2,
+  "total_floor_area": 69,
+  "transaction_type": 13,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "pvc_window_frames": "true",
+  "registration_date": "2022-04-13",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_u_value": 0.33,
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 39.5,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 15.8,
+            "quantity": "metres"
+          },
+          "floor_construction": 2,
+          "heat_loss_perimeter": {
+            "value": 10,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 39.5,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 15.8,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 10,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "G",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 75,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 340,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.3,
+  "energy_rating_average": 60,
+  "energy_rating_current": 73,
+  "lighting_cost_current": {
+    "value": 74,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 324,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 122,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 21,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W1",
+      "improvement_details": {
+        "improvement_number": 57
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 13,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a310",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 42,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 77
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 363,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 88,
+      "environmental_impact_rating": 88
+    }
+  ],
+  "co2_emissions_potential": 0.8,
+  "energy_rating_potential": 88,
+  "lighting_cost_potential": {
+    "value": 59,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 77,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2568,
+    "space_heating_existing_dwelling": 5020
+  },
+  "energy_consumption_current": 185,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.1.0",
+  "energy_consumption_potential": 66,
+  "environmental_impact_current": 72,
+  "fixed_lighting_outlets_count": 8,
+  "windows_transmission_details": {
+    "u_value": 2.8,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 88,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 33,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_60027826/elmhurst_inputs.md

@@ -0,0 +1,182 @@
+# Elmhurst RdSAP inputs — UPRN 60027826 (cert 0080-2673-2086-2299-1061, RdSAP-Schema-20.0.0)
+
+**Lodged SAP:** 72   **Our engine:** 70   ← compare Elmhurst against **70** (the production gov-API path)
+**Known divergences:** None of the off-peak Economy-7 bugs apply — this is a **mains-gas** boiler with **mains-gas** hot water. Watch instead: (a) RdSAP-20 synthesised-window U translation, (b) the room-in-roof entry, (c) the unlodged party wall defaulting to U=0.25.
+
+10 Kingsland Close, Shoreham-by-Sea, BN43 6NQ · Semi-detached house · inspected 2021-08-17, lodged 2022-04-13.
+
+---
+
+## Property Description
+
+| Elmhurst field | Value | Notes (SAP code / EES path) |
+|---|---|---|
+| Property Type | House | `property_type` 0 |
+| Built Form | Semi-detached | `built_form` 2 |
+| Age Band (England & Wales) | **H — 1991–1995** | `construction_age_band` H |
+| Storeys | **3** | ground + first + room-in-roof (intermediate `storey_count`=3.0) |
+| Habitable rooms | 6 | `habitable_room_count` |
+| Heated rooms | 6 | `heated_room_count` |
+| Extensions | 0 | `extensions_count` |
+| Rooms in roof | **Yes — 1** | `sap_room_in_roof` lodged (see Roofs) |
+
+## Dimensions  (`measurement_type` 1 = Internal)
+
+| Floor | Area m² | Room Height m | Heat-Loss Perimeter m | Party-Wall Length m |
+|---|---|---|---|---|
+| Ground (floor 0) | **42.85** | 2.3 | 21.7 | 6 |
+| First (floor 1) | **36** | 2.3 | 18 | 6 |
+| Room-in-roof | **36** | (entered on Rooms-in-Roof page, not as a dimension floor) | — | — |
+
+TFA check: 42.85 + 36 + 36 = **114.85 m²** (lodged `total_floor_area` 115). No heated basement.
+
+## Conservatory
+
+None — `conservatory_type` 1, `has_heated_separate_conservatory` false → leave unchecked.
+
+## Walls
+
+**Main / external wall**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Construction | **Cavity wall** | `wall_construction` 4; description "Cavity wall, filled cavity" |
+| Insulation | **Filled cavity** | `wall_insulation_type` 2 (retrofit cavity fill) |
+| Dry-lined | **Yes** | `wall_dry_lined` Y |
+| Wall Thickness | **300 mm** | `wall_thickness` 300; `wall_thickness_measured` Y → "Wall Thickness Unknown" unchecked |
+| (cross-check) | lodged `wall_u_value` 0.33; engine `walls_w_per_k` 26.27 | |
+
+No alternative wall lodged.
+
+**Party wall** — `party_wall_construction` **0 (not lodged)**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | **Unable to determine** | code 0 → engine default **U = 0.25** (NOT the code-1 "Solid" trap — here it is genuinely unlodged, so "Unable to determine" is correct and matches the engine). Engine `party_walls_w_per_k` 7.275 ≈ 29 m² × 0.25. |
+
+## Roofs
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | **Room in roof** (pitched, slates/tiles) | description "Roof room(s), insulated (assumed)"; `roof_construction` 4 |
+| Rooms-in-roof area | **36 m²** | `sap_room_in_roof.floor_area` 36 |
+| Rooms-in-roof insulation | **As built** | `sap_room_in_roof.insulation` "AB"; age band H; `roof_room_connected` N |
+| Roof insulation location | **At joists** | `roof_insulation_location` 2 |
+| Roof insulation thickness | **100 mm** | `roof_insulation_thickness` "100mm" (drives default U) |
+| (cross-check) | engine `roof_w_per_k` 24.17 | |
+
+## Floors
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Construction | **Solid** | `floor_construction` 1; description "Solid, no insulation (assumed)" |
+| Insulation | **As built** (none) | `floor_insulation_thickness` "NI" |
+| (cross-check) | engine `floor_w_per_k` 30.0 | |
+
+## Openings — Windows  (RdSAP reduced-data, synthesised)
+
+Glazed-area band = **Normal** (`glazed_area` 1, ×1.00). Synthesised total glazing area
+= 0.148 × 114.85 × 1.00 = **17.02 m²**, split 4-way N/E/S/W (4 windows × 4.255 m wide × 1.0 m high).
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Glazing Type | **Double, unknown install date** | `multiple_glazing_type` 3; "Fully double glazed" |
+| Frame Type | **PVC** | `pvc_window_frames` true |
+| Glazing Gap | **16 mm** | `glazing_gap` "16+" |
+| Orientation | spread evenly N / E / S / W | not lodged — matches engine synth (orients 1,3,5,7) |
+| Location | External wall | |
+| Draught Proofed | **Yes (100%)** | `percent_draughtproofed` 100 |
+| U-value / g-value | leave Elmhurst default; **lodged U = 2.6, g = 0.76** | `windows_transmission_details`; engine effective U = `windows_w_per_k` 42.86 ÷ 17.02 ≈ **2.52**. ⚠️ Report the U Elmhurst assigns — RdSAP-20 glazing-coefficient translation is the most likely source of the lodged-72-vs-engine-70 gap. |
+
+## Openings — Doors
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Total doors | **2** | `door_count` 2 |
+| Insulated | **0** | `insulated_door_count` 0 |
+| Draught proofed | 2 | `percent_draughtproofed` 100 → engine `doors_w_per_k` 11.1 ≈ 2 × 1.85 m² × 3.0 |
+
+## Ventilation & Lighting
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Open chimneys | 0 | `open_fireplaces_count` 0 |
+| Open flues / passive vents / flueless gas / extract fans | 0 | none lodged |
+| Fixed air conditioning | No | `has_fixed_air_conditioning` false |
+| Mechanical Ventilation | **Natural** (unchecked) | `mechanical_ventilation` 0 |
+| Air Pressure Test | **Not available** (uses % draughtproofing) | RdSAP cert |
+| Lighting — total fixed outlets | **14** | `fixed_lighting_outlets_count` 14 |
+| Lighting — low-energy outlets | **12** | `low_energy_fixed_lighting_outlets_count` 12 (86%) |
+
+## Space Heating
+
+**Main Heating 1** — `sap_main_heating_code` **102**
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| System | **Boiler + radiators, mains gas** | "Boiler and radiators, mains gas"; `main_heating_category` 2; `heat_emitter_type` 1 = radiators |
+| Boiler type | **Regular condensing, automatic ignition** | code 102 (Table 4b) |
+| Efficiency | **84% winter / 74% summer** | Table 4b code 102; engine `main_heating_efficiency` 0.84. `main_heating_data_source` 2 (age-band/Table default, no PCDB record) |
+| Fuel | **Mains gas** | `main_fuel_type` 26 (engine space-heat cost 3.48 p/kWh) |
+| Flue | Fanned flue present | `boiler_flue_type` 2, `fan_flue_present` Y |
+| Controls | **Programmer + room thermostat + TRVs** | `main_heating_control` 2106 |
+| % of heat | 100% | `main_heating_fraction` 1 |
+| Heat Emitter / Pump Age | leave default (no PCDF) | `central_heating_pump_age` 0 |
+
+**Main Heating 2** — none (single main system).
+
+**Secondary Heating** — leave Elmhurst **default (assumed portable electric heaters)**.
+`secondary_heating_type` 691; engine applies fraction **0.1** at **standard-tariff electricity** (fuel 30), `secondary_heating_fuel_kwh` ≈ 976 kWh. (Cert lodges `secondary_fuel_type` 29 but the engine prices the assumed secondary at standard tariff per SAP convention — leave the Elmhurst default and it agrees.)
+
+**Community Heating** — none.
+
+## Meters
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Mains gas supply available | **Yes** | `sap_energy_source.mains_gas` Y |
+| Electricity meter type | **Single (standard)** | `meter_type` 1 — no Economy-7 here; off-peak fuel-cost bug **does not apply** |
+
+## Water Heating
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Source | **From main heating system** (Boiler Circulator) | `water_heating_code` 901; "From main system" |
+| Fuel | **Mains gas** | `water_heating_fuel` 26 (engine HW cost 3.48 p/kWh) |
+| Hot Water Cylinder Present | **Yes** | `has_hot_water_cylinder` true |
+| Cylinder size | **110 L** (pick the litre value, not "Normal") | `cylinder_size` code 2 = 110 L |
+| Cylinder insulation type | **Factory foam** | `cylinder_insulation_type` 1 = Foam |
+| Cylinder insulation thickness | **50 mm** | `cylinder_insulation_thickness` 50 |
+| Cylinder thermostat | **Yes** | `cylinder_thermostat` Y |
+| (cross-check) | engine `hot_water_kwh_per_yr` 3640 | |
+
+- **Number of baths** (Water Heating → **WWHRS sub-tab → "Total no. of Baths"**): **1**
+  — `instantaneous_wwhrs.rooms_with_bath_and_or_shower` 1 + `rooms_with_bath_and_mixer_shower` 0 = 1. Elmhurst defaults to 0; set it to **1** or HW demand diverges.
+- **WWHRS**: **No** — the `instantaneous_wwhrs` block is bath/shower ROOM counts (ADR-0028), not a heat-recovery device.
+- **Community Hot Water**: none.
+- **Solar Water Heating**: No — `solar_water_heating` N.
+- **FGHRS**: No — `main_heating_details[].has_fghrs` N.
+
+## New Technologies
+
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| PV | **None** | `photovoltaic_supply.none_or_no_details` |
+| Wind | **None** | `wind_turbines_count` 0 |
+| Hydro | None | not lodged |
+| Special Features (Appendix Q) | None | not lodged |
+
+---
+
+### Engine reference outputs (the numbers Elmhurst should reproduce)
+
+| Quantity | Engine value |
+|---|---|
+| SAP score (integer) | **70** (continuous 69.77) |
+| Space-heating demand | 9 755 kWh/yr |
+| Main-heating fuel (gas) | 10 452 kWh/yr |
+| Hot-water | 3 640 kWh/yr |
+| Secondary (electric, assumed) | 976 kWh/yr |
+| CO₂ | 3 184 kg/yr |
+| Total fuel cost | £824.73/yr |
+| Heat-transfer coefficient | 245.96 W/K |
+| Heat-loss parameter | 2.14 W/m²K |
+
+**Operator: key this into Elmhurst, then export the Summary PDF (`elmhurst_summary.pdf`) and the SAP-10.2 worksheet PDF (`elmhurst_worksheet.pdf`) into this directory, and report the Elmhurst SAP score.** Then re-run `scripts/compare_epc_paths.py 60027826` to diff the two paths.

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-20.0.0/uprn_60027826/epc.json

@@ -0,0 +1,343 @@
+{
+  "uprn": 60027826,
+  "roofs": [
+    {
+      "description": {
+        "value": "Roof room(s), insulated (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": {
+        "value": "Cavity wall, filled cavity",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": {
+        "value": "Solid, no insulation (assumed)",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": {
+      "value": "Fully double glazed",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": {
+      "value": "Low energy lighting in 86% of fixed outlets",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "BN43 6NQ",
+  "hot_water": {
+    "description": {
+      "value": "From main system",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "SHOREHAM-BY-SEA",
+  "built_form": 2,
+  "created_at": "2022-04-13 09:33:39.943417",
+  "door_count": 2,
+  "glazed_area": 1,
+  "glazing_gap": "16+",
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "instantaneous_wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 102,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 691,
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.94,
+  "schema_type": "RdSAP-Schema-20.0.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": {
+        "value": "Boiler and radiators, mains gas",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": {
+    "value": "Semi-detached house",
+    "language": "1"
+  },
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10 KINGSLAND CLOSE",
+  "assessment_type": "RdSAP",
+  "completion_date": "2022-04-13",
+  "inspection_date": "2021-08-17",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 115,
+  "transaction_type": 13,
+  "conservatory_type": 1,
+  "heated_room_count": 6,
+  "pvc_window_frames": "true",
+  "registration_date": "2022-04-13",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "pv_connection": 0,
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": {
+      "value": "None",
+      "language": "1"
+    },
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_u_value": 0.33,
+      "wall_dry_lined": "Y",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "sap_room_in_roof": {
+        "floor_area": {
+          "value": 36,
+          "quantity": "square metres"
+        },
+        "insulation": "AB",
+        "roof_room_connected": "N",
+        "construction_age_band": "H"
+      },
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 42.85,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 6,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 21.7,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.3,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 36,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 6,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 18,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "H",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "100mm",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 86,
+  "solar_water_heating": "N",
+  "habitable_room_count": 6,
+  "heating_cost_current": {
+    "value": 522,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 72,
+  "lighting_cost_current": {
+    "value": 111,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": {
+        "value": "Programmer, room thermostat and TRVs",
+        "language": "1"
+      },
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 3,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 486,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 129,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 37,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 71
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 42,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 400,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a35,500",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 84,
+      "environmental_impact_rating": 81
+    }
+  ],
+  "co2_emissions_potential": 1.8,
+  "energy_rating_potential": 84,
+  "lighting_cost_potential": {
+    "value": 111,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-19.0",
+  "hot_water_cost_potential": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2737,
+    "impact_of_loft_insulation": -71,
+    "space_heating_existing_dwelling": 8821
+  },
+  "energy_consumption_current": 167,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "2.1.1.0",
+  "energy_consumption_potential": 89,
+  "environmental_impact_current": 69,
+  "fixed_lighting_outlets_count": 14,
+  "windows_transmission_details": {
+    "u_value": 2.6,
+    "data_source": 2,
+    "solar_transmittance": 0.76
+  },
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 81,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 29,
+  "low_energy_fixed_lighting_outlets_count": 12
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_10013924849/epc.json

@@ -0,0 +1,322 @@
+{
+  "uprn": 10013924849,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "To unheated space, insulated (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": "Excellent lighting efficiency",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME20 7FH",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "AYLESFORD",
+  "psv_count": 0,
+  "built_form": 4,
+  "created_at": "2025-12-09 17:27:01",
+  "door_count": 1,
+  "region_code": 1,
+  "report_type": 2,
+  "sap_heating": {
+    "number_baths": 1,
+    "cylinder_size": 1,
+    "shower_outlets": [
+      {
+        "shower_outlet": {
+          "shower_wwhrs": 1,
+          "shower_outlet_type": 1
+        }
+      }
+    ],
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "secondary_fuel_type": 0,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 0,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17863
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 10.2,
+  "sap_windows": [
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": 1.19,
+      "window_height": 1.12,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": 1.75,
+      "window_height": 1.12,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": 1.75,
+      "window_height": 2.07,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 3,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": 1.1,
+      "window_height": 1.12,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    }
+  ],
+  "schema_type": "RdSAP-Schema-21.0.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "(not tested)",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "pressure_test": 4,
+  "property_type": 2,
+  "address_line_1": "Flat 1",
+  "address_line_2": "Riverview Court",
+  "address_line_3": "2 Kings Crescent",
+  "assessment_type": "RdSAP",
+  "completion_date": "2025-12-09",
+  "inspection_date": "2025-12-01",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "open_flues_count": 0,
+  "sap_flat_details": {
+    "level": 2,
+    "top_storey": "N",
+    "flat_location": 1,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": {
+      "value": 13.58,
+      "quantity": "metres"
+    }
+  },
+  "total_floor_area": 52,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "has_draught_lobby": "true",
+  "heated_room_count": 3,
+  "other_flues_count": 0,
+  "registration_date": "2025-12-09",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "pv_diverter": "false",
+    "pv_connection": 0,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "gas_smart_meter_present": "true",
+    "is_dwelling_export_capable": "false",
+    "wind_turbines_terrain_type": 2,
+    "electricity_smart_meter_present": "true",
+    "is_hydro_output_connected_to_dwelling_meter": "false"
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "closed_flues_count": 0,
+  "extract_fans_count": 2,
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 340,
+      "floor_heat_loss": 2,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.34,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 52.07,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 6.19,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 25.95,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "L",
+      "sap_alternative_wall_1": {
+        "wall_area": 31.78,
+        "sheltered_wall": "Y",
+        "wall_dry_lined": "N",
+        "wall_thickness": 320,
+        "wall_construction": 4,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y"
+      },
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "boilers_flues_count": 0,
+  "open_chimneys_count": 0,
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 313,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1,
+  "energy_rating_average": 60,
+  "energy_rating_current": 80,
+  "lighting_cost_current": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "blocked_chimneys_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 313,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 137,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 1,
+  "energy_rating_potential": 80,
+  "lighting_cost_potential": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-21.0.1",
+  "flueless_gas_fires_count": 0,
+  "hot_water_cost_potential": {
+    "value": 137,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1835.24,
+    "space_heating_existing_dwelling": 2203.68
+  },
+  "draughtproofed_door_count": 1,
+  "energy_consumption_current": 108,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "4.3.74",
+  "energy_consumption_potential": 108,
+  "environmental_impact_current": 85,
+  "cfl_fixed_lighting_bulbs_count": 0,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 85,
+  "led_fixed_lighting_bulbs_count": 9,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 19,
+  "incandescent_fixed_lighting_bulbs_count": 0
+}

backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_10023443426/epc.json

@@ -0,0 +1,468 @@
+{
+  "uprn": 10023443426,
+  "roofs": [
+    {
+      "description": "Pitched, 300 mm loft insulation",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, insulated (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 3,
+    "environmental_efficiency_rating": 3
+  },
+  "lighting": {
+    "description": "Excellent lighting efficiency",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 5TY",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "psv_count": 0,
+  "built_form": 3,
+  "created_at": "2026-02-09 21:22:01",
+  "door_count": 2,
+  "region_code": 2,
+  "report_type": 2,
+  "sap_heating": {
+    "number_baths": 1,
+    "cylinder_size": 1,
+    "shower_outlets": [
+      {
+        "shower_outlet": {
+          "shower_wwhrs": 1,
+          "shower_outlet_type": 1
+        }
+      }
+    ],
+    "number_baths_wwhrs": 0,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "N",
+    "secondary_fuel_type": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "central_heating_pump_age": 0,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17045
+      }
+    ],
+    "immersion_heating_type": "NA",
+    "secondary_heating_type": 612,
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 10.2,
+  "sap_windows": [
+    {
+      "pvc_frame": "true",
+      "orientation": 5,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 1.79,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.29,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 7,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.855,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.15,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.59,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 0.99,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.58,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 7,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.87,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.14,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.59,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.28,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.59,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.28,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 7,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.87,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.12,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 5,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.87,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.12,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 7,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.87,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 1.13,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "orientation": 7,
+      "window_type": 1,
+      "glazing_type": 2,
+      "window_width": {
+        "value": 0.617,
+        "quantity": "m"
+      },
+      "window_height": {
+        "value": 0.6,
+        "quantity": "m"
+      },
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    }
+  ],
+  "schema_type": "RdSAP-Schema-21.0.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "(not tested)",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "pressure_test": 4,
+  "property_type": 0,
+  "address_line_1": "1 Dale Street",
+  "assessment_type": "RdSAP",
+  "completion_date": "2026-02-09",
+  "inspection_date": "2026-02-09",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "open_flues_count": 0,
+  "total_floor_area": 98,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "other_flues_count": 0,
+  "registration_date": "2026-02-09",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "pv_connection": 0,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "gas_smart_meter_present": "true",
+    "is_dwelling_export_capable": "false",
+    "wind_turbines_terrain_type": 2,
+    "electricity_smart_meter_present": "true"
+  },
+  "secondary_heating": {
+    "description": "Room heaters, mains gas",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "closed_flues_count": 0,
+  "extract_fans_count": 3,
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 320,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 48.97,
+          "party_wall_length": 9.2,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 22.14
+        },
+        {
+          "floor": 1,
+          "room_height": 2.3,
+          "total_floor_area": 49.22,
+          "party_wall_length": 9.2,
+          "heat_loss_perimeter": 22.12
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "L",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "300mm",
+      "wall_insulation_thickness": "NI"
+    }
+  ],
+  "boilers_flues_count": 0,
+  "open_chimneys_count": 0,
+  "solar_water_heating": "N",
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 647,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 76,
+  "lighting_cost_current": {
+    "value": 72,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "blocked_chimneys_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 647,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 180,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "schema_version_current": "LIG-21.0",
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": 290,
+      "indicative_cost": "\u00a38,000 - \u00a310,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 78
+    }
+  ],
+  "co2_emissions_potential": 2.0,
+  "energy_rating_potential": 85,
+  "lighting_cost_potential": {
+    "value": 72,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-21.0",
+  "hot_water_cost_potential": {
+    "value": 180,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2417.03,
+    "space_heating_existing_dwelling": 5002.38
+  },
+  "draughtproofed_door_count": 2,
+  "energy_consumption_current": 126,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "10.2.2.0",
+  "energy_consumption_potential": 108,
+  "environmental_impact_current": 76,
+  "cfl_fixed_lighting_bulbs_count": 0,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 78,
+  "led_fixed_lighting_bulbs_count": 9,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 23,
+  "incandescent_fixed_lighting_bulbs_count": 0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.0/uprn_100020933894/epc.json

@@ -0,0 +1,302 @@
+{
+  "uprn": 100020933894,
+  "roofs": [
+    {
+      "description": "Pitched, 100 mm loft insulation",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "walls": [
+    {
+      "description": "Solid brick, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "No low energy lighting",
+    "energy_efficiency_rating": 1,
+    "environmental_efficiency_rating": 1
+  },
+  "postcode": "SE9 1SL",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 2,
+  "created_at": "2012-06-05 07:15:18.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "secondary_fuel_type": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 10328,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "secondary_heating_type": 691,
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Admiral Seymour Road",
+  "schema_version": "LIG-16.0",
+  "assessment_type": "RdSAP",
+  "completion_date": "2012-06-05",
+  "inspection_date": "2012-05-23",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 92,
+  "transaction_type": 3,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2012-06-05",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 1
+  },
+  "secondary_heating": {
+    "description": "Room heaters, electric",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "Y",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 54.08,
+        "wall_dry_lined": "Y",
+        "wall_thickness": 340,
+        "wall_construction": 3,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.5,
+          "floor_insulation": 1,
+          "total_floor_area": 45.79,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 22.91
+        },
+        {
+          "floor": 1,
+          "room_height": 2.58,
+          "total_floor_area": 45.79,
+          "heat_loss_perimeter": 22.91
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "B",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "100mm"
+    }
+  ],
+  "low_energy_lighting": 0,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 323,
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 767,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 4.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 56,
+  "lighting_cost_current": {
+    "value": 98,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 493,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 87,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 231,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a314,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 67,
+      "environmental_impact_rating": 67
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 51,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 69,
+      "environmental_impact_rating": 70
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 41,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a350",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 72
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 25,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 227,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 82
+    }
+  ],
+  "co2_emissions_potential": 1.6,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 49,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 62,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2211,
+    "impact_of_loft_insulation": -413,
+    "impact_of_solid_wall_insulation": -5030,
+    "space_heating_existing_dwelling": 13580
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 254,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "1.1.8.0",
+  "energy_consumption_potential": 91,
+  "environmental_impact_current": 54,
+  "fixed_lighting_outlets_count": 10,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 82,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 48,
+  "low_energy_fixed_lighting_outlets_count": 0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.1/uprn_100021943298/elmhurst_inputs.md

@@ -0,0 +1,98 @@
+# Elmhurst RdSAP inputs — UPRN 100021943298 (cert 0498-6963-7270-0822-1980, SAP-Schema-16.1)
+
+**Lodged SAP:** 72   **Our engine:** 76 (continuous ~75.x)   ← compare Elmhurst against the engine
+**Property:** Ground-floor FLAT, age band B (1900–1929), mains-gas combi + radiators, TFA 78 m²
+
+**Schema note:** SAP-Schema-16.1 is reduced-field (RdSAP-shaped) — mapped via the
+new `from_sap_schema_16_1` → `_normalize_sap_schema_16_x` → `from_rdsap_schema_17_1`.
+Descriptions + glazed-area band, no measured U-values, so engine and Elmhurst should
+both use RdSAP age-band/description U-values — expect TIGHTER agreement (the +4 over
+lodged is the reconciliation target).
+
+**Known divergences / gaps to watch:**
+- **Party wall:** 16.1 lodges no `party_wall_length`; normalizer defaults 0 → engine
+  models no party wall. For a ground-floor flat the side/party walls to other dwellings
+  are handled by Elmhurst's Flat position + corridor — keep party-wall length 0 and check
+  the worksheet party-wall line.
+- Age band B → Elmhurst on-screen band **B 1900-1929**.
+
+## Property Description
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Property Type | **Flat** | property_type 2 |
+| Built form | **End-Terrace** | built_form 3 |
+| Age band | **B 1900-1929** | construction_age_band B |
+| Storeys | 1 | ground-floor flat, single storey |
+| Habitable rooms | 3 | habitable_room_count 3 |
+
+## Flats
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Position of flat | **Ground Floor** | dwelling_type "Ground-floor flat" |
+| Floor | 0 | ground = storey 0 |
+| Corridor | None | all-exposed (no unheated corridor lodged) |
+
+## Dimensions
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Floor area (lowest) | 77.69 m² | floor 0 |
+| Room height | 2.65 m | room_height |
+| Heat-loss perimeter | 28.9 m | heat_loss_perimeter |
+| Party-wall length | **0** | 16.1 lodges none |
+
+## Walls
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Construction | **Solid Brick** | wall_construction 3 |
+| Insulation | **Internal** | wall_insulation_type 3 = internal insulation ("Solid brick, with internal insulation") |
+| Thickness | (as built) | wall_thickness_measured True |
+
+## Roofs
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | **Another dwelling above** | roof "(another dwelling above)" → no roof heat loss |
+
+## Floors
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Location / type | Ground floor / **Suspended** | "Suspended, no insulation (assumed)" |
+| Insulation | **As built** (none) | no insulation |
+
+## Openings
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Windows | **Double glazed**, total 11.544 m² (4 × 2.886, N/E/S/W) | glazed_area band 1, multiple_glazing_type 2 (double). Enter ONE combined "Double …" row of 11.544 m². |
+| Doors | **2, uninsulated** | door_count 2, insulated_door_count 0 |
+
+## Ventilation & Lighting
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Ventilation | Natural | no MV |
+| Extract fans / flues | 0 / 0 | none lodged |
+| Sheltered sides | 1 | sheltered_sides 1 |
+| Air Pressure Test | **Not available** (no test lodged) | clear any Blower Door |
+| Lighting | **100% low-energy** (6 of 6 outlets) | low_energy 6 / total 6 |
+
+## Space Heating
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Main heating | Mains gas **combi** + radiators | fuel 26, emitter 1, control 2106, fan flue, PCDB 10328, category 2, NO cylinder → BGW condensing combi cascade |
+| Secondary | None | secondary "None" |
+
+## Water Heating
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Water heating | From main (901), gas | water_heating from combi |
+| Hot water cylinder | **None** | has_hot_water_cylinder False (combi/instantaneous) |
+| Solar / WWHRS / FGHRS | None | — |
+
+## Fields to clear in Elmhurst (do NOT map)
+| Elmhurst field | Set to | Why absent |
+|---|---|---|
+| Conservatory | none | not lodged |
+| Air Pressure Test method | **Not available** | no test lodged (clear any prior Blower Door) |
+| Mechanical ventilation | off | natural ventilation |
+| Cylinder size/insulation | (gone — combi) | no cylinder |
+| Main Heating 2 / Secondary | none | single combi system |
+| PV / Wind / Hydro | none | none lodged |
+| Room-in-roof / extensions | blank | single building part, no RiR |

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.1/uprn_100021943298/epc.json

@@ -0,0 +1,232 @@
+{
+  "uprn": 100021943298,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Solid brick, with internal insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE4 1YN",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2012-10-02 23:16:59.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 10328,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "11a, Chalsey Road",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2012-10-02",
+  "inspection_date": "2012-10-01",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 0
+  },
+  "total_floor_area": 78,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2012-10-02",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.65,
+          "floor_insulation": 1,
+          "total_floor_area": 77.69,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 28.9
+        }
+      ],
+      "wall_insulation_type": 3,
+      "construction_age_band": "B",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "50mm"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 329,
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 421,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 72,
+  "lighting_cost_current": {
+    "value": 46,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 360,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 61,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 77
+    }
+  ],
+  "co2_emissions_potential": 2.0,
+  "energy_rating_potential": 75,
+  "lighting_cost_potential": {
+    "value": 46,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2121,
+    "space_heating_existing_dwelling": 7355
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 160,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.0,
+  "energy_consumption_potential": 137,
+  "environmental_impact_current": 72,
+  "fixed_lighting_outlets_count": 6,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 77,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 31,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100020235156/epc.json

@@ -0,0 +1,262 @@
+{
+  "uprn": 100020235156,
+  "roofs": [
+    {
+      "description": "Pitched, 150 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    },
+    {
+      "description": "Timber frame, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, limited insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in 91% of fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA8 2PG",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "ERITH",
+  "built_form": 3,
+  "created_at": "2013-12-09 17:52:34.000000",
+  "door_count": 3,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 9462,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Raleigh Close",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-12-09",
+  "inspection_date": "2013-12-09",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 87,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "registration_date": "2013-12-09",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 10.53,
+        "wall_dry_lined": "N",
+        "wall_construction": 5,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "N"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 43.45,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 18.9
+        },
+        {
+          "floor": 1,
+          "room_height": 2.35,
+          "total_floor_area": 43.45,
+          "heat_loss_perimeter": 18.9
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "I",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "150mm"
+    }
+  ],
+  "low_energy_lighting": 91,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 351,
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 407,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 74,
+  "lighting_cost_current": {
+    "value": 59,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 409,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 121,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 37,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 254,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 85
+    }
+  ],
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 85,
+  "lighting_cost_potential": {
+    "value": 59,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 81,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2790,
+    "impact_of_loft_insulation": -251,
+    "space_heating_existing_dwelling": 6514
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 145,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 69,
+  "environmental_impact_current": 74,
+  "fixed_lighting_outlets_count": 11,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 28,
+  "low_energy_fixed_lighting_outlets_count": 10
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100020933699/elmhurst_inputs.md

@@ -0,0 +1,86 @@
+# Elmhurst RdSAP inputs — UPRN 100020933699 (cert 9548-2053-6299-9947-0950, SAP-Schema-16.2)
+
+**Lodged SAP:** 70   **Our engine:** 72 (continuous 72.29)   ← compare Elmhurst against the engine
+**Property:** End-terrace HOUSE, age band G (1983–1990), mains-gas regular boiler + cylinder, TFA 62 m²
+
+**Schema note:** SAP-Schema-16.2 is RdSAP-shaped (reduced-field) — mapped via `_normalize_sap_schema_16_2` → RdSAP-17.1 mapper. This is a REDUCED-FIELD cert (descriptions + glazed-area band, no measured U-values), so unlike the 17.1 new-builds the engine and Elmhurst should both use RdSAP age-band/description U-values — expect a TIGHTER agreement.
+
+**Known divergences / gaps to watch:**
+- **Party wall:** 16.2 does not lodge `party_wall_length`; the normalizer defaults it to 0, so the engine currently models NO party wall. An end-terrace HAS one party wall — Elmhurst will model it. **This is the likely main divergence; check the worksheet party-wall line.**
+- Age band G → Elmhurst on-screen band **G 1983-1990**.
+
+## Property Description
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Property Type | **House** | dwelling_type "End-terrace house" (switch from FLAT — prior cert) |
+| Built form | **End-Terrace** | built_form 3 |
+| Age band | **G 1983-1990** | construction_age_band G |
+| Storeys | 2 | floor 0 + floor 1 |
+| Habitable rooms | 4 | habitable_room_count 4 |
+
+## Dimensions
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Ground floor area | 31.06 m² | floor 0 |
+| First floor area | 31.06 m² | floor 1 |
+| Room height (ground / first) | 2.40 / 2.65 m | room_height |
+| Heat-loss perimeter (each) | 15.8 m | heat_loss_perimeter |
+| Party-wall length (each) | **see note** | 16.2 lodges none; for an end-terrace enter the real party-wall length if Elmhurst derives it from built-form, else note the divergence |
+
+## Walls
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Construction | Cavity | wall_construction 4 |
+| Insulation | **Filled** | wall_insulation_type 2 = filled cavity ("Cavity wall, filled cavity") |
+| Thickness | 280 mm | wall_thickness |
+| Party wall | Present (End-Terrace) — Unable to determine | built_form 3 |
+
+## Roofs
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Type | Pitched, access to loft | roof_construction 4 |
+| Insulation at | Joists | roof_insulation_location 2 |
+| Thickness | 100 mm | roof_insulation_thickness "100mm" |
+
+## Floors
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Location / type | Ground floor / Solid | floor_construction 1 |
+| Insulation | **None** | "Solid, no insulation (assumed)" |
+
+## Openings
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Windows | **Single glazed**, glazed-area band Normal | glazed_area 1, multiple_glazing_type ND, "Single glazed" |
+| Doors | **2 doors, uninsulated** | door_count 2, insulated_door_count 0 (high U — solid/older doors) |
+
+## Ventilation & Lighting
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Ventilation | Natural | no MV; no air-permeability test lodged (ap50/ap4 None) |
+| Extract fans / flues | 0 / 0 | none lodged; open chimneys 0 |
+| Sheltered sides | 1 | sheltered_sides 1 |
+| Air Pressure Test | **None** (do NOT enter Blower Door) | no test lodged — leave method blank |
+| Lighting | 22% low-energy | low_energy 2 / total 9 outlets |
+
+## Space Heating
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Main heating | Mains gas **regular boiler + radiators** | fuel 26, emitter 1, control 2106, fan-assisted flue, PCDB 10321. NOT a combi — has a cylinder → use the BGB regular condensing/non-condensing cascade option (per age band G, likely non-condensing) |
+| Secondary | None | secondary "None" |
+
+## Water Heating
+| Elmhurst field | Value | Notes |
+|---|---|---|
+| Water heating | From main (901), gas | water_heating_fuel 26 |
+| Hot water cylinder | **Present** — 110 L (Normal), Foam, 25 mm | has_hot_water_cylinder True, cylinder_size 2, insulation type 1 (foam) 25 mm |
+| Solar / WWHRS / FGHRS | None | — |
+
+## Fields to clear in Elmhurst (do NOT map)
+| Elmhurst field | Set to | Why absent |
+|---|---|---|
+| Flats page | (gone — House now) | switch from prior FLAT cert |
+| Conservatory | none / uncheck | not lodged |
+| Air Pressure Test method | **blank** | no test lodged (prior certs had Blower Door — CLEAR it) |
+| Main Heating 2 / Secondary | none | single system |
+| PV / Wind / Hydro | none | none lodged |

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100020933699/epc.json

@@ -0,0 +1,310 @@
+{
+  "uprn": 100020933699,
+  "roofs": [
+    {
+      "description": "Pitched, 100 mm loft insulation",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, filled cavity",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Single glazed",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in 22% of fixed outlets",
+    "energy_efficiency_rating": 2,
+    "environmental_efficiency_rating": 2
+  },
+  "postcode": "SE18 2PE",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2013-01-14 15:52:33.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 10321,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Acland Close",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-01-14",
+  "inspection_date": "2013-01-14",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 62,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2013-01-14",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.4,
+          "floor_insulation": 1,
+          "total_floor_area": 31.06,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 15.8
+        },
+        {
+          "floor": 1,
+          "room_height": 2.4,
+          "total_floor_area": 31.06,
+          "heat_loss_perimeter": 15.8
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "G",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "100mm"
+    }
+  ],
+  "low_energy_lighting": 22,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 333,
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 370,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 70,
+  "lighting_cost_current": {
+    "value": 66,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": "ND",
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 296,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 106,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 27,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 73
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 26,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a335",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 33,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 52,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,300 - \u00a36,500",
+      "improvement_type": "O",
+      "improvement_details": {
+        "improvement_number": 8
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 80
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 236,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 89,
+      "environmental_impact_rating": 92
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 19,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a31,500 - \u00a34,000",
+      "improvement_type": "V",
+      "improvement_details": {
+        "improvement_number": 44
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 90,
+      "environmental_impact_rating": 92
+    }
+  ],
+  "co2_emissions_potential": 0.5,
+  "energy_rating_potential": 90,
+  "lighting_cost_potential": {
+    "value": 37,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 72,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2577,
+    "impact_of_loft_insulation": -309,
+    "space_heating_existing_dwelling": 5864
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 189,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 0,
+  "calculation_software_version": 8.0,
+  "energy_consumption_potential": 36,
+  "environmental_impact_current": 71,
+  "fixed_lighting_outlets_count": 9,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 92,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 36,
+  "low_energy_fixed_lighting_outlets_count": 2
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100020973465/epc.json

@@ -0,0 +1,423 @@
+{
+  "uprn": 100020973465,
+  "roofs": [
+    {
+      "description": "Pitched, 75 mm loft insulation",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    },
+    {
+      "description": "Pitched, limited insulation (assumed)",
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "walls": [
+    {
+      "description": "Timber frame, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 1,
+  "windows": [
+    {
+      "description": "Single glazed",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE28 0DQ",
+  "hot_water": {
+    "description": "From main system, no cylinder thermostat",
+    "energy_efficiency_rating": 2,
+    "environmental_efficiency_rating": 2
+  },
+  "post_town": "LONDON",
+  "built_form": 4,
+  "created_at": "2013-09-17 14:55:12.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "N",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "N",
+        "heat_emitter_type": 1,
+        "main_heating_number": 1,
+        "main_heating_control": 2104,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 101,
+        "main_heating_data_source": 2
+      }
+    ],
+    "cylinder_insulation_type": 2,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 12
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Harrier Mews",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-09-17",
+  "inspection_date": "2013-09-17",
+  "windows_u_value": 4.8,
+  "extensions_count": 1,
+  "measurement_type": 1,
+  "total_floor_area": 83,
+  "transaction_type": 5,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "registration_date": "2013-09-17",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 5,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.31,
+          "floor_insulation": 1,
+          "total_floor_area": 26.16,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 3.52
+        },
+        {
+          "floor": 1,
+          "room_height": 2.32,
+          "total_floor_area": 26.15,
+          "heat_loss_perimeter": 7.04
+        },
+        {
+          "floor": 2,
+          "room_height": 2.38,
+          "total_floor_area": 26.15,
+          "heat_loss_perimeter": 17.47
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "F",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "75mm"
+    },
+    {
+      "identifier": "Extension 1",
+      "wall_dry_lined": "N",
+      "wall_thickness": 280,
+      "floor_heat_loss": 7,
+      "roof_construction": 5,
+      "wall_construction": 5,
+      "building_part_number": 2,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.31,
+          "floor_insulation": 1,
+          "total_floor_area": 4.64,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 3.52
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "F",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "NI"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_transmittance": 0.85,
+  "solar_water_heating": "N",
+  "windows_data_source": 2,
+  "bedf_revision_number": 343,
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 501,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 61,
+  "lighting_cost_current": {
+    "value": 48,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer and room thermostat",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "multiple_glazing_type": "ND",
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 334,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 302,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 0,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 20.88,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3100  -  \u00a3350",
+      "improvement_type": "A",
+      "improvement_details": {
+        "improvement_number": 5
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 62,
+      "environmental_impact_rating": 59
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 71.87,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315  -  \u00a330",
+      "improvement_type": "C",
+      "improvement_details": {
+        "improvement_number": 2
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 65,
+      "environmental_impact_rating": 63
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 29.08,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a380  -  \u00a3120",
+      "improvement_type": "D",
+      "improvement_details": {
+        "improvement_number": 10
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 67,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 68.14,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3200  -  \u00a3400",
+      "improvement_type": "F",
+      "improvement_details": {
+        "improvement_number": 4
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 70,
+      "environmental_impact_rating": 69
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 22.3,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3350  -  \u00a3450",
+      "improvement_type": "G",
+      "improvement_details": {
+        "improvement_number": 13
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 70
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 77.25,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200  -  \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 7,
+      "typical_saving": {
+        "value": 36.41,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000  -  \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 77
+    },
+    {
+      "sequence": 8,
+      "typical_saving": {
+        "value": 64.15,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,300  -  \u00a36,500",
+      "improvement_type": "O",
+      "improvement_details": {
+        "improvement_number": 8
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 9,
+      "typical_saving": {
+        "value": 242.65,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000  -  \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 89,
+      "environmental_impact_rating": 90
+    }
+  ],
+  "co2_emissions_potential": 0.8,
+  "energy_rating_potential": 89,
+  "lighting_cost_potential": {
+    "value": 49,
+    "currency": "GBP"
+  },
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 42.48,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 88.11,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 74
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 79,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 5230,
+    "impact_of_loft_insulation": -516,
+    "space_heating_existing_dwelling": 6902
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 242,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 0,
+  "calculation_software_version": "1.4.1.0",
+  "energy_consumption_potential": 46,
+  "environmental_impact_current": 58,
+  "fixed_lighting_outlets_count": 11,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 90,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 47,
+  "low_energy_fixed_lighting_outlets_count": 11
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100021985993/epc.json

@@ -0,0 +1,273 @@
+{
+  "uprn": 100021985993,
+  "roofs": [
+    {
+      "description": "Pitched, 100 mm loft insulation",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "walls": [
+    {
+      "description": "Solid brick, with internal insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE12 9PZ",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2013-03-15 12:45:25.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 10328,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "End-terrace bungalow",
+  "language_code": 1,
+  "property_type": 1,
+  "address_line_1": "1 Gatehouse Cottages",
+  "address_line_2": "Marvels Lane",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-03-15",
+  "inspection_date": "2013-03-15",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 77,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2013-03-15",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 360,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 76.54,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 29.1
+        }
+      ],
+      "wall_insulation_type": 3,
+      "construction_age_band": "C",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "100mm",
+      "wall_insulation_thickness": "50mm"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 335,
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 480,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 70,
+  "lighting_cost_current": {
+    "value": 44,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 392,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 86,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 30,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3100 - \u00a3350",
+      "improvement_type": "A",
+      "improvement_details": {
+        "improvement_number": 5
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 71
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 58,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 25,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 236,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 86,
+      "environmental_impact_rating": 86
+    }
+  ],
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 86,
+  "lighting_cost_potential": {
+    "value": 44,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 62,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2112,
+    "impact_of_loft_insulation": -766,
+    "space_heating_existing_dwelling": 8674
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 181,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 69,
+  "environmental_impact_current": 69,
+  "fixed_lighting_outlets_count": 6,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 35,
+  "low_energy_fixed_lighting_outlets_count": 6
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100062116493/epc.json

@@ -0,0 +1,251 @@
+{
+  "uprn": 100062116493,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, partial insulation (assumed)",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "addendum": {
+    "cavity_fill_recommended": "true"
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME2 3QD",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "ROCHESTER",
+  "built_form": 1,
+  "created_at": "2013-11-24 19:51:36.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 15502,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1, Roan Court",
+  "address_line_2": "Abbey Road",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-11-24",
+  "inspection_date": "2013-11-24",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 0
+  },
+  "total_floor_area": 41,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 2,
+  "registration_date": "2013-11-24",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 310,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 40.8,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 26.2
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "F",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 350,
+  "habitable_room_count": 2,
+  "heating_cost_current": {
+    "value": 367,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.8,
+  "energy_rating_average": 60,
+  "energy_rating_current": 68,
+  "lighting_cost_current": {
+    "value": 27,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 262,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 67,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 56,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3500 - \u00a31,500",
+      "improvement_type": "B",
+      "improvement_details": {
+        "improvement_number": 6
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 72,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 48,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 80
+    }
+  ],
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 76,
+  "lighting_cost_potential": {
+    "value": 27,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 67,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1561,
+    "impact_of_cavity_insulation": -1381,
+    "space_heating_existing_dwelling": 5530
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 227,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 155,
+  "environmental_impact_current": 70,
+  "fixed_lighting_outlets_count": 5,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 80,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 44,
+  "low_energy_fixed_lighting_outlets_count": 5
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_10008048040/epc.json

@@ -0,0 +1,277 @@
+{
+  "uprn": 10008048040,
+  "roofs": [
+    {
+      "description": "Pitched, 200 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Timber frame, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Suspended, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "PE2 8NL",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "PETERBOROUGH",
+  "built_form": 4,
+  "created_at": "2013-09-11 16:33:41.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 2,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 15502,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Barber Close",
+  "address_line_2": "Stanground",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-09-11",
+  "inspection_date": "2013-09-10",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 57,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2013-09-11",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 3,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 290,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 5,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.4,
+          "floor_insulation": 1,
+          "total_floor_area": 29.34,
+          "floor_construction": 2,
+          "heat_loss_perimeter": 9.83
+        },
+        {
+          "floor": 1,
+          "room_height": 2.43,
+          "total_floor_area": 28.06,
+          "heat_loss_perimeter": 9.2
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "200mm"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 346,
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 334,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 75,
+  "lighting_cost_current": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 310,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 78,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 23,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 24,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 81
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 245,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 90,
+      "environmental_impact_rating": 93
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 19,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a31,500 - \u00a34,000",
+      "improvement_type": "V",
+      "improvement_details": {
+        "improvement_number": 44
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 91,
+      "environmental_impact_rating": 94
+    }
+  ],
+  "co2_emissions_potential": 0.4,
+  "energy_rating_potential": 91,
+  "lighting_cost_potential": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 54,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1822,
+    "space_heating_existing_dwelling": 4717
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 154,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 30,
+  "environmental_impact_current": 77,
+  "fixed_lighting_outlets_count": 7,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 94,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 29,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_100090182288/epc.json

@@ -0,0 +1,261 @@
+{
+  "uprn": 100090182288,
+  "roofs": [
+    {
+      "description": "Pitched, 250 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, filled cavity",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "PE1 4JH",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "PETERBOROUGH",
+  "built_form": 2,
+  "created_at": "2013-03-08 12:16:12.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 2,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 10327,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Central Avenue",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2013-03-08",
+  "inspection_date": "2013-03-06",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 73,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2013-03-08",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 1,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 290,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.43,
+          "floor_insulation": 1,
+          "total_floor_area": 36.72,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 21.46
+        },
+        {
+          "floor": 1,
+          "room_height": 2.45,
+          "total_floor_area": 36.72,
+          "heat_loss_perimeter": 21.46
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "D",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 335,
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 440,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 2.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 71,
+  "lighting_cost_current": {
+    "value": 46,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 402,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 85,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 38,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 24,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 248,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 86,
+      "environmental_impact_rating": 86
+    }
+  ],
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 86,
+  "lighting_cost_potential": {
+    "value": 46,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 61,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2085,
+    "space_heating_existing_dwelling": 7620
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 172,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 74,
+  "environmental_impact_current": 72,
+  "fixed_lighting_outlets_count": 7,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 33,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_10014314798/epc.json

@@ -0,0 +1,320 @@
+{
+  "uprn": 10014314798,
+  "roofs": [
+    {
+      "description": "Average thermal transmittance 0.12 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.20 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.12 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME15 6RG",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 4,
+  "created_at": "2013-10-11 15:44:30.000000",
+  "living_area": 19.67,
+  "orientation": 8,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "has_wwhrs": "false",
+    "thermal_store": 1,
+    "has_solar_panel": "false",
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "has_fghrs": "false",
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "boiler_index_number": 16661,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2110,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1.0,
+        "main_heating_flue_type": 5,
+        "main_heating_data_source": 1,
+        "is_oil_pump_in_heated_space": "true",
+        "has_delayed_start_thermostat": "false",
+        "load_or_weather_compensation": 2,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1
+  },
+  "sap_version": 9.9,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 2.6 m\u00c2\u00b3/h.m\u00c2\u00b2 (as tested)",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Farleigh Hill",
+  "schema_version": "LIG-15.0",
+  "assessment_date": "2013-10-11",
+  "assessment_type": "SAP",
+  "completion_date": "2013-10-10",
+  "inspection_date": "2013-10-11",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "air_permeability": 2.6,
+    "open_flues_count": 0,
+    "ventilation_type": 1,
+    "extract_fans_count": 3,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "flueless_gas_fires_count": 0
+  },
+  "sap_data_version": 9.91,
+  "total_floor_area": 73,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2013-10-11",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 20,
+    "low_energy_fixed_lighting_outlets_count": 20,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 2,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    },
+    {
+      "name": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "0 100 + 250 Rockwool Cross Laid",
+          "u_value": 0.12,
+          "roof_type": 2,
+          "description": "100 + 250 Rockwool Cross Laid",
+          "kappa_value": 9.0,
+          "total_roof_area": 36.27
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "(Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "kappa_value": 9.0,
+          "total_wall_area": 59.5,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "3 Filled & Sealed Cavity",
+          "u_value": 0.0,
+          "wall_type": 4,
+          "description": "Filled & Sealed Cavity",
+          "kappa_value": 20.0,
+          "total_wall_area": 66.5,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "1 Farleigh Hill, Tovil, Maidstone, Kent, ME15 6RG",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.88,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 4
+        },
+        {
+          "name": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 3.36,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 8
+        },
+        {
+          "name": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.14,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 8
+        },
+        {
+          "name": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.52,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 4
+        }
+      ],
+      "construction_year": 2013,
+      "sap_thermal_bridges": {
+        "thermal_bridge_code": 1
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.12,
+          "floor_type": 2,
+          "description": "Beam/Celcon Std Block/150 Celotex/Screed",
+          "kappa_value": 75.0,
+          "storey_height": 2.4,
+          "heat_loss_area": 36.27,
+          "total_floor_area": 36.27
+        }
+      ]
+    }
+  ],
+  "bedf_revision_number": 346,
+  "heating_cost_current": 235,
+  "co2_emissions_current": 1.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": 52,
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": 235,
+  "hot_water_cost_current": 72,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": 25,
+      "indicative_cost": "\u00c2\u00a34,000 - \u00c2\u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 84,
+      "environmental_impact_rating": 88
+    },
+    {
+      "sequence": 2,
+      "typical_saving": 233,
+      "indicative_cost": "\u00c2\u00a39,000 - \u00c2\u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 95,
+      "environmental_impact_rating": 99
+    }
+  ],
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 83,
+  "lighting_cost_potential": 52,
+  "hot_water_cost_potential": 72,
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 2134,
+      "water_heating": 1757
+    }
+  },
+  "seller_commission_report": "N",
+  "energy_consumption_current": 86,
+  "has_fixed_air_conditioning": "false",
+  "calculation_software_version": "5.04a3",
+  "energy_consumption_potential": 86,
+  "environmental_impact_current": 86,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 16,
+  "additional_allowable_electricity_generation": 0.0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.2/uprn_10014314830/epc.json

@@ -0,0 +1,322 @@
+{
+  "uprn": 10014314830,
+  "roofs": [
+    {
+      "description": "Average thermal transmittance 0.12 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.20 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.11 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME15 6NX",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 4,
+  "created_at": "2014-01-24 09:08:21.000000",
+  "living_area": 16.11,
+  "orientation": 1,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "has_wwhrs": "false",
+    "thermal_store": 1,
+    "has_solar_panel": "false",
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "has_fghrs": "false",
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "boiler_index_number": 16661,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2110,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1.0,
+        "main_heating_flue_type": 5,
+        "main_heating_data_source": 1,
+        "is_oil_pump_in_heated_space": "true",
+        "has_delayed_start_thermostat": "false",
+        "load_or_weather_compensation": 2,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1,
+    "sap_heating_design_water_use": 1
+  },
+  "sap_version": 9.9,
+  "schema_type": "SAP-Schema-16.2",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 5.5 m\u00c2\u00b3/h.m\u00c2\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, George Street",
+  "schema_version": "LIG-15.0",
+  "assessment_date": "2014-01-23",
+  "assessment_type": "SAP",
+  "completion_date": "2014-01-23",
+  "inspection_date": "2014-01-23",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "air_permeability": 5.52,
+    "open_flues_count": 0,
+    "ventilation_type": 1,
+    "extract_fans_count": 5,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "flueless_gas_fires_count": 0
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.91,
+  "total_floor_area": 76,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2014-01-24",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 23,
+    "low_energy_fixed_lighting_outlets_count": 23,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 2,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    },
+    {
+      "name": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "0 350 Rockwool Cross Laid",
+          "u_value": 0.12,
+          "roof_type": 2,
+          "description": "350 Rockwool Cross Laid",
+          "kappa_value": 9.0,
+          "total_roof_area": 38.01
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "(Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "kappa_value": 9.0,
+          "total_wall_area": 45.62,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "3 Filled & Sealed Cavity",
+          "u_value": 0.0,
+          "wall_type": 4,
+          "description": "Filled & Sealed Cavity",
+          "kappa_value": 20.0,
+          "total_wall_area": 86.0,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "10 George Street, Maidstone, Kent, ME15 6NX",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 3.15,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 1
+        },
+        {
+          "name": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 3.96,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 5
+        },
+        {
+          "name": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.16,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 1
+        },
+        {
+          "name": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "1 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.52,
+          "height": 1.0,
+          "location": "1 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 5
+        }
+      ],
+      "construction_year": 2014,
+      "sap_thermal_bridges": {
+        "thermal_bridge_code": 1
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.11,
+          "floor_type": 2,
+          "description": "Beam/Celcon Std Block/150 Celotex/Screed",
+          "kappa_value": 75.0,
+          "storey_height": 2.4,
+          "heat_loss_area": 38.01,
+          "total_floor_area": 38.01
+        }
+      ]
+    }
+  ],
+  "bedf_revision_number": 352,
+  "heating_cost_current": 243,
+  "co2_emissions_current": 1.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": 55,
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": 243,
+  "hot_water_cost_current": 74,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": 26,
+      "indicative_cost": "\u00c2\u00a34,000 - \u00c2\u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 84,
+      "environmental_impact_rating": 88
+    },
+    {
+      "sequence": 2,
+      "typical_saving": 241,
+      "indicative_cost": "\u00c2\u00a39,000 - \u00c2\u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 95,
+      "environmental_impact_rating": 98
+    }
+  ],
+  "co2_emissions_potential": 1.2,
+  "energy_rating_potential": 83,
+  "lighting_cost_potential": 55,
+  "hot_water_cost_potential": 74,
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 2240,
+      "water_heating": 1711
+    }
+  },
+  "seller_commission_report": "N",
+  "energy_consumption_current": 84,
+  "has_fixed_air_conditioning": "false",
+  "calculation_software_version": "5.04a3",
+  "energy_consumption_potential": 84,
+  "environmental_impact_current": 87,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 87,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 16,
+  "additional_allowable_electricity_generation": 0.0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_100020980961/epc.json

@@ -0,0 +1,313 @@
+{
+  "uprn": 100020980961,
+  "roofs": [
+    {
+      "description": "Pitched, 250 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Solid brick, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    },
+    {
+      "description": "Cavity wall, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 2,
+      "environmental_efficiency_rating": 2
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "addendum": {
+    "cavity_fill_recommended": "true"
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE10 0AA",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2014-10-24 09:39:31.000000",
+  "door_count": 2,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 15100,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Kossuth Street",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-10-24",
+  "inspection_date": "2014-10-23",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 81,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 4,
+  "registration_date": "2014-10-24",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 3,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 240,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 3,
+      "building_part_number": 1,
+      "sap_alternative_wall": {
+        "wall_area": 17.1,
+        "sheltered_wall": "N",
+        "wall_dry_lined": "N",
+        "wall_thickness": 290,
+        "wall_construction": 4,
+        "wall_insulation_type": 4,
+        "wall_thickness_measured": "Y"
+      },
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.43,
+          "floor_insulation": 1,
+          "total_floor_area": 40.12,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 20.78
+        },
+        {
+          "floor": 1,
+          "room_height": 2.37,
+          "total_floor_area": 41.32,
+          "heat_loss_perimeter": 18.78
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "E",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "250mm"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 365,
+  "habitable_room_count": 4,
+  "heating_cost_current": {
+    "value": 627,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.3,
+  "energy_rating_average": 60,
+  "energy_rating_current": 65,
+  "lighting_cost_current": {
+    "value": 51,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 391,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 124,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 33,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3500 - \u00a31,500",
+      "improvement_type": "B",
+      "improvement_details": {
+        "improvement_number": 6
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 67,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 159,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a314,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 46,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 41,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 77,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 258,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 87,
+      "environmental_impact_rating": 88
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 87,
+  "lighting_cost_potential": {
+    "value": 51,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 83,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2608,
+    "impact_of_cavity_insulation": -726,
+    "impact_of_solid_wall_insulation": -3540,
+    "space_heating_existing_dwelling": 10860
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 209,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "v2.1.0",
+  "energy_consumption_potential": 58,
+  "environmental_impact_current": 63,
+  "fixed_lighting_outlets_count": 10,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 88,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 40,
+  "low_energy_fixed_lighting_outlets_count": 10
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_100022015916/epc.json

@@ -0,0 +1,355 @@
+{
+  "uprn": 100022015916,
+  "roofs": [
+    {
+      "description": "Pitched, 100 mm loft insulation",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Single glazed",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in 73% of fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE8 4DN",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 2,
+  "created_at": "2014-09-04 16:24:17.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 1964,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Vanguard Street",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-09-04",
+  "inspection_date": "2014-09-03",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "total_floor_area": 84,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 5,
+  "registration_date": "2014-09-04",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 1
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.33,
+          "floor_insulation": 1,
+          "total_floor_area": 42.9,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 18.84
+        },
+        {
+          "floor": 1,
+          "room_height": 2.42,
+          "total_floor_area": 41.51,
+          "heat_loss_perimeter": 18.24
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "100mm"
+    }
+  ],
+  "low_energy_lighting": 73,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 365,
+  "habitable_room_count": 5,
+  "heating_cost_current": {
+    "value": 588,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 3.3,
+  "energy_rating_average": 60,
+  "energy_rating_current": 66,
+  "lighting_cost_current": {
+    "value": 67,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": "ND",
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 382,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 152,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 24,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3100 - \u00a3350",
+      "improvement_type": "A",
+      "improvement_details": {
+        "improvement_number": 5
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 67,
+      "environmental_impact_rating": 65
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 49,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 69,
+      "environmental_impact_rating": 68
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 12,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 70,
+      "environmental_impact_rating": 68
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 103,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 74
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 40,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 76
+    },
+    {
+      "sequence": 6,
+      "typical_saving": {
+        "value": 63,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,300 - \u00a36,500",
+      "improvement_type": "O",
+      "improvement_details": {
+        "improvement_number": 8
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 80
+    },
+    {
+      "sequence": 7,
+      "typical_saving": {
+        "value": 258,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 88,
+      "environmental_impact_rating": 89
+    }
+  ],
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 88,
+  "lighting_cost_potential": {
+    "value": 54,
+    "currency": "GBP"
+  },
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 75,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 75
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 118,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 73
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 81,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2556,
+    "impact_of_loft_insulation": -430,
+    "space_heating_existing_dwelling": 8096
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 202,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 0,
+  "calculation_software_version": "1.14r10",
+  "energy_consumption_potential": 54,
+  "environmental_impact_current": 64,
+  "fixed_lighting_outlets_count": 11,
+  "current_energy_efficiency_band": "D",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 39,
+  "low_energy_fixed_lighting_outlets_count": 8
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_100062188801/epc.json

@@ -0,0 +1,277 @@
+{
+  "uprn": 100062188801,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, filled cavity",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "RH11 7UG",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "CRAWLEY",
+  "built_form": 3,
+  "created_at": "2014-02-25 19:25:58.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 8587,
+        "main_heating_number": 1,
+        "main_heating_control": 2107,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "Flat 10 Ashmore House",
+  "address_line_2": "Dobson Road",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-02-25",
+  "inspection_date": "2014-02-25",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 0
+  },
+  "total_floor_area": 24,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 1,
+  "registration_date": "2014-02-25",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 270,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 24.48,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 15.6
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "E",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 353,
+  "habitable_room_count": 1,
+  "heating_cost_current": {
+    "value": 277,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 70,
+  "lighting_cost_current": {
+    "value": 19,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, TRVs and bypass",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 215,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 71,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 39,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 30,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 75,
+      "environmental_impact_rating": 82
+    }
+  ],
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 75,
+  "lighting_cost_potential": {
+    "value": 19,
+    "currency": "GBP"
+  },
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 38,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 78,
+      "environmental_impact_rating": 93
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 97,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 83
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 63,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1372,
+    "space_heating_existing_dwelling": 2525
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 261,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 186,
+  "environmental_impact_current": 75,
+  "fixed_lighting_outlets_count": 4,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 82,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 50,
+  "low_energy_fixed_lighting_outlets_count": 4
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_10014314853/epc.json

@@ -0,0 +1,398 @@
+{
+  "uprn": 10014314853,
+  "roofs": [
+    {
+      "description": "Average thermal transmittance 0.14 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.20 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.11 W/m\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME15 6NG",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "MAIDSTONE",
+  "built_form": 3,
+  "created_at": "2014-03-04 16:44:28.000000",
+  "living_area": 16.11,
+  "orientation": 1,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "has_wwhrs": "false",
+    "thermal_store": 1,
+    "has_solar_panel": "false",
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "has_fghrs": "false",
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "boiler_index_number": 16661,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2110,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1.0,
+        "main_heating_flue_type": 5,
+        "main_heating_data_source": 1,
+        "is_oil_pump_in_heated_space": "true",
+        "has_delayed_start_thermostat": "false",
+        "load_or_weather_compensation": 2,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1,
+    "sap_heating_design_water_use": 1
+  },
+  "sap_version": 9.9,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 3.7 m\u00c2\u00b3/h.m\u00c2\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "End-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1, Regency Place",
+  "schema_version": "LIG-15.0",
+  "assessment_date": "2014-03-04",
+  "assessment_type": "SAP",
+  "completion_date": "2014-03-03",
+  "inspection_date": "2014-03-04",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "air_permeability": 3.66,
+    "open_flues_count": 0,
+    "ventilation_type": 1,
+    "extract_fans_count": 5,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "flueless_gas_fires_count": 0
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.91,
+  "total_floor_area": 95,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2014-03-04",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 25,
+    "low_energy_fixed_lighting_outlets_count": 25,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "1 0 Velux Standard Specified U-Value = 1.40 165 + 30 Celotex Inter/Under Rafter",
+      "type": 5,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "3 0 Specified U-Value = 1.40 Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "4 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "4 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "4 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "4 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 2,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    },
+    {
+      "name": "4 4 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "glazing_type": 3
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "0 150 Celotex",
+          "u_value": 0.15,
+          "roof_type": 2,
+          "description": "150 Celotex",
+          "kappa_value": 9.0,
+          "total_roof_area": 1.68
+        },
+        {
+          "name": "1 165 + 30 Celotex Inter/Under Rafter",
+          "u_value": 0.14,
+          "roof_type": 2,
+          "description": "165 + 30 Celotex Inter/Under Rafter",
+          "kappa_value": 9.0,
+          "total_roof_area": 33.23
+        },
+        {
+          "name": "2 350 Rockwool Cross Laid",
+          "u_value": 0.12,
+          "roof_type": 2,
+          "description": "350 Rockwool Cross Laid",
+          "kappa_value": 9.0,
+          "total_roof_area": 10.55
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "3 Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+          "kappa_value": 9.0,
+          "total_wall_area": 2.94,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "(Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "kappa_value": 9.0,
+          "total_wall_area": 96.64,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "6 Filled & Sealed Cavity",
+          "u_value": 0.0,
+          "wall_type": 4,
+          "description": "Filled & Sealed Cavity",
+          "kappa_value": 20.0,
+          "total_wall_area": 51.03,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "1 Regency Place, Maidstone, Kent, ME15 6NG",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": "1 0 Velux Standard Specified U-Value = 1.40 165 + 30 Celotex Inter/Under Rafter",
+          "type": "1 0 Velux Standard Specified U-Value = 1.40 165 + 30 Celotex Inter/Under Rafter",
+          "width": 0.65,
+          "height": 1.0,
+          "location": "1 165 + 30 Celotex Inter/Under Rafter",
+          "orientation": 9
+        },
+        {
+          "name": "3 0 Specified U-Value = 1.40 Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+          "type": "3 0 Specified U-Value = 1.40 Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+          "width": 1.26,
+          "height": 1.0,
+          "location": "3 Dormer Cheeks Insulated With 100 Celotex Between Studs/35 Celotex Over Studs/12.5 P'bd",
+          "orientation": 1
+        },
+        {
+          "name": "4 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "4 0 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 3.96,
+          "height": 1.0,
+          "location": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 5
+        },
+        {
+          "name": "4 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "4 1 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 3.15,
+          "height": 1.0,
+          "location": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 1
+        },
+        {
+          "name": "4 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "4 2 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 1.44,
+          "height": 1.0,
+          "location": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 7
+        },
+        {
+          "name": "4 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "4 3 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.16,
+          "height": 1.0,
+          "location": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 1
+        },
+        {
+          "name": "4 4 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "type": "4 4 Specified U-Value = 1.40 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "width": 2.52,
+          "height": 1.0,
+          "location": "4 (Brick) or Tiles on Battens or Render/100 Medium Dense Aggregate Block/50 Cavity/140 Timber Frame Insulated With 120 Kingspan TW55/12.5 P'bd (Specified U-Value = 0.20)",
+          "orientation": 5
+        }
+      ],
+      "construction_year": 2014,
+      "sap_thermal_bridges": {
+        "thermal_bridge_code": 1
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.11,
+          "floor_type": 2,
+          "description": "Beam/Celcon Std Block/150 Celotex/Screed",
+          "kappa_value": 75.0,
+          "storey_height": 2.4,
+          "heat_loss_area": 38.01,
+          "total_floor_area": 38.01
+        }
+      ]
+    }
+  ],
+  "bedf_revision_number": 353,
+  "heating_cost_current": 278,
+  "co2_emissions_current": 1.4,
+  "energy_rating_average": 60,
+  "energy_rating_current": 84,
+  "lighting_cost_current": 62,
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": 278,
+  "hot_water_cost_current": 79,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": 27,
+      "indicative_cost": "\u00c2\u00a34,000 - \u00c2\u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 88
+    },
+    {
+      "sequence": 2,
+      "typical_saving": 241,
+      "indicative_cost": "\u00c2\u00a39,000 - \u00c2\u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 94,
+      "environmental_impact_rating": 96
+    }
+  ],
+  "co2_emissions_potential": 1.4,
+  "energy_rating_potential": 84,
+  "lighting_cost_potential": 62,
+  "hot_water_cost_potential": 79,
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 3021,
+      "water_heating": 1828
+    }
+  },
+  "seller_commission_report": "N",
+  "energy_consumption_current": 79,
+  "has_fixed_air_conditioning": "false",
+  "calculation_software_version": "5.04a3",
+  "energy_consumption_potential": 79,
+  "environmental_impact_current": 86,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 15,
+  "additional_allowable_electricity_generation": 0.0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_10090844948/epc.json

@@ -0,0 +1,455 @@
+{
+  "uprn": 10090844948,
+  "roofs": [
+    {
+      "description": "Average thermal transmittance 0.10 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.19 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.17 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SO23 7GN",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "WINCHESTER",
+  "built_form": 2,
+  "created_at": "2014-03-10 15:49:05.000000",
+  "living_area": 15.7,
+  "orientation": 1,
+  "region_code": 16,
+  "report_type": 3,
+  "sap_heating": {
+    "thermal_store": 1,
+    "has_solar_panel": "false",
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "boiler_index_number": 16843,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "main_heating_data_source": 1,
+        "has_delayed_start_thermostat": "false",
+        "load_or_weather_compensation": 0,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1
+  },
+  "sap_version": 9.9,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 5.0 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Semi-detached house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "1 Burnet Lane",
+  "address_line_2": "Kings Worthy",
+  "schema_version": "LIG-16.0",
+  "assessment_date": "2014-03-10",
+  "assessment_type": "SAP",
+  "completion_date": "2014-03-10",
+  "inspection_date": "2014-03-10",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "wet_rooms_count": 3,
+    "air_permeability": 4.951,
+    "open_flues_count": 0,
+    "ventilation_type": 6,
+    "extract_fans_count": 0,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "kitchen_duct_fans_count": 0,
+    "kitchen_room_fans_count": 1,
+    "kitchen_wall_fans_count": 0,
+    "flueless_gas_fires_count": 0,
+    "mechanical_vent_duct_type": 2,
+    "non_kitchen_duct_fans_count": 0,
+    "non_kitchen_room_fans_count": 2,
+    "non_kitchen_wall_fans_count": 0,
+    "mechanical_ventilation_data_source": 1,
+    "mechanical_vent_system_index_number": 500229,
+    "is_mechanical_vent_approved_installer_scheme": "true"
+  },
+  "design_water_use": 1,
+  "total_floor_area": 93,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2014-03-10",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 10,
+    "low_energy_fixed_lighting_outlets_count": 10,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": 1,
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "description": "-",
+      "frame_factor": 0.7,
+      "glazing_type": 6,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": 12,
+      "type": 1,
+      "u_value": 1.1,
+      "data_source": 2,
+      "glazing_type": 1
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "Roof 1",
+          "u_value": 0.1,
+          "roof_type": 2,
+          "description": "Roof 1",
+          "total_roof_area": 46.36
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "Wall 1",
+          "u_value": 0.19,
+          "wall_type": 2,
+          "description": "Wall 1",
+          "total_wall_area": 114.78,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 2",
+          "u_value": 0,
+          "wall_type": 4,
+          "description": "Wall 2",
+          "total_wall_area": 28.33
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": 1,
+          "width": 0.5,
+          "height": 1,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 2,
+          "type": 1,
+          "width": 0.5,
+          "height": 1,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 3,
+          "type": 1,
+          "width": 1,
+          "height": 1.33,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 4,
+          "type": 1,
+          "width": 1,
+          "height": 1.2,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 5,
+          "type": 1,
+          "width": 1.6,
+          "height": 1.2,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 6,
+          "type": 1,
+          "width": 1.6,
+          "height": 1.4,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 7,
+          "type": 1,
+          "width": 1.36,
+          "height": 2.1,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 8,
+          "type": 1,
+          "width": 1.6,
+          "height": 1.4,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 9,
+          "type": 1,
+          "width": 0.5,
+          "height": 1.3,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 10,
+          "type": 1,
+          "width": 1.6,
+          "height": 1.4,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 11,
+          "type": 1,
+          "width": 1.6,
+          "height": 1.4,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 12,
+          "type": 12,
+          "width": 0.9,
+          "height": 2.1,
+          "location": "Wall 1",
+          "orientation": 0
+        }
+      ],
+      "construction_year": 2013,
+      "sap_thermal_bridges": {
+        "thermal_bridges": [
+          {
+            "length": 13.76,
+            "psi_value": 0.3,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 2
+          },
+          {
+            "length": 13.76,
+            "psi_value": 0.04,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 3
+          },
+          {
+            "length": 33.66,
+            "psi_value": 0.05,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 4
+          },
+          {
+            "length": 15.7,
+            "psi_value": 0.16,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 5
+          },
+          {
+            "length": 15.7,
+            "psi_value": 0.07,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 6
+          },
+          {
+            "length": 17.15,
+            "psi_value": 0.06,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 10
+          },
+          {
+            "length": 7.79,
+            "psi_value": 0.24,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 12
+          },
+          {
+            "length": 20.56,
+            "psi_value": 0.09,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 14
+          },
+          {
+            "length": 20.56,
+            "psi_value": 0.06,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 16
+          },
+          {
+            "length": 5.12,
+            "psi_value": 0.08,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 21
+          },
+          {
+            "length": 5.12,
+            "psi_value": 0,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 22
+          },
+          {
+            "length": 5.12,
+            "psi_value": 0.12,
+            "psi_value_source": 2,
+            "thermal_bridge_type": 24
+          }
+        ],
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.17,
+          "floor_type": 2,
+          "description": "Floor 1",
+          "storey_height": 2.46,
+          "heat_loss_area": 46.36,
+          "total_floor_area": 46.36
+        },
+        {
+          "storey": 1,
+          "u_value": 0,
+          "floor_type": 3,
+          "storey_height": 2.68,
+          "heat_loss_area": 0,
+          "total_floor_area": 46.36
+        }
+      ],
+      "thermal_mass_parameter": 250
+    }
+  ],
+  "bedf_revision_number": 354,
+  "heating_cost_current": 287,
+  "co2_emissions_current": 1.5,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": 54,
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": 287,
+  "hot_water_cost_current": 83,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": 27,
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 84,
+      "environmental_impact_rating": 87
+    },
+    {
+      "sequence": 2,
+      "typical_saving": 241,
+      "indicative_cost": "\u00a39,000 - \u00a314,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 3,
+      "energy_performance_rating": 93,
+      "environmental_impact_rating": 96
+    }
+  ],
+  "co2_emissions_potential": 1.5,
+  "energy_rating_potential": 83,
+  "lighting_cost_potential": 54,
+  "hot_water_cost_potential": 83,
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 2702,
+      "water_heating": 1911
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 83,
+  "has_fixed_air_conditioning": "false",
+  "calculation_software_version": 5.5,
+  "energy_consumption_potential": 83,
+  "environmental_impact_current": 86,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 86,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 16
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_200003398613/epc.json

@@ -0,0 +1,213 @@
+{
+  "uprn": 200003398613,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "(other premises below)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "SE15 6ND",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 4,
+  "created_at": "2014-11-26 18:56:49.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 1,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 16839,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "has_fixed_air_conditioning": "false"
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "10, Colegrove Road",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-11-26",
+  "inspection_date": "2014-11-25",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 2,
+    "top_storey": "N",
+    "flat_location": 1,
+    "heat_loss_corridor": 0
+  },
+  "total_floor_area": 33,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 2,
+  "registration_date": "2014-11-26",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 270,
+      "floor_heat_loss": 6,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.37,
+          "floor_insulation": 1,
+          "total_floor_area": 33.06,
+          "heat_loss_perimeter": 11.6
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "H",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "low_energy_lighting": 100,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 365,
+  "habitable_room_count": 2,
+  "heating_cost_current": {
+    "value": 206,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 0.8,
+  "energy_rating_average": 60,
+  "energy_rating_current": 79,
+  "lighting_cost_current": {
+    "value": 24,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 1,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 206,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 64,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 0.8,
+  "energy_rating_potential": 79,
+  "lighting_cost_potential": {
+    "value": 24,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 64,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 1390,
+    "space_heating_existing_dwelling": 1510
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 130,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "v2.1.0",
+  "energy_consumption_potential": 130,
+  "environmental_impact_current": 85,
+  "fixed_lighting_outlets_count": 7,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 25,
+  "low_energy_fixed_lighting_outlets_count": 7
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_200003400077/epc.json

@@ -0,0 +1,311 @@
+{
+  "uprn": 200003400077,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, filled cavity",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in 60% of fixed outlets",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "postcode": "SE15 6RH",
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "LONDON",
+  "built_form": 3,
+  "created_at": "2014-05-14 18:06:22.000000",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 17,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 0
+    },
+    "cylinder_size": 2,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 5928,
+        "main_heating_number": 1,
+        "main_heating_control": 2104,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 25
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "Flat 1 Vervain House",
+  "address_line_2": "7, Hereford Retreat",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-05-14",
+  "inspection_date": "2014-05-14",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": 5.4
+  },
+  "total_floor_area": 32,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 2,
+  "registration_date": "2014-05-14",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 300,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 32.4,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 16.8
+        }
+      ],
+      "wall_insulation_type": 2,
+      "construction_age_band": "E",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "low_energy_lighting": 60,
+  "solar_water_heating": "N",
+  "bedf_revision_number": 358,
+  "habitable_room_count": 2,
+  "heating_cost_current": {
+    "value": 261,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.5,
+  "energy_rating_average": 60,
+  "energy_rating_current": 70,
+  "lighting_cost_current": {
+    "value": 32,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer and room thermostat",
+      "energy_efficiency_rating": 3,
+      "environmental_efficiency_rating": 3
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 207,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 122,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 41,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a3800 - \u00a31,200",
+      "improvement_type": "W",
+      "improvement_details": {
+        "improvement_number": 47
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 78
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 9,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a315 - \u00a330",
+      "improvement_type": "C",
+      "improvement_details": {
+        "improvement_number": 3
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 73,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 8,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a310",
+      "improvement_type": "E",
+      "improvement_details": {
+        "improvement_number": 35
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 74,
+      "environmental_impact_rating": 79
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 33,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a32,200 - \u00a33,000",
+      "improvement_type": "I",
+      "improvement_details": {
+        "improvement_number": 20
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 82
+    }
+  ],
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 76,
+  "lighting_cost_potential": {
+    "value": 23,
+    "currency": "GBP"
+  },
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 61,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 80,
+      "environmental_impact_rating": 93
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 115,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z1",
+      "improvement_details": {
+        "improvement_number": 51
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 83,
+      "environmental_impact_rating": 84
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 93,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2254,
+    "space_heating_existing_dwelling": 2411
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 235,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 161,
+  "environmental_impact_current": 74,
+  "fixed_lighting_outlets_count": 5,
+  "current_energy_efficiency_band": "C",
+  "environmental_impact_potential": 82,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "C",
+  "co2_emissions_current_per_floor_area": 45,
+  "low_energy_fixed_lighting_outlets_count": 3
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-16.3/uprn_44012843/epc.json

@@ -0,0 +1,222 @@
+{
+  "uprn": 44012843,
+  "roofs": [
+    {
+      "description": "(another dwelling above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Cavity wall, as built, insulated (assumed)",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, insulated (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 2,
+  "windows": [
+    {
+      "description": "Fully double glazed",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "lighting": {
+    "description": "Low energy lighting in 80% of fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME2 2BN",
+  "hot_water": {
+    "description": "From main system, plus solar",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "post_town": "ROCHESTER",
+  "built_form": 3,
+  "created_at": "2014-02-18 23:08:35",
+  "door_count": 1,
+  "glazed_area": 1,
+  "region_code": 14,
+  "report_type": 2,
+  "sap_heating": {
+    "wwhrs": {
+      "rooms_with_bath_and_or_shower": 1,
+      "rooms_with_mixer_shower_no_bath": 0,
+      "rooms_with_bath_and_mixer_shower": 1
+    },
+    "cylinder_size": 4,
+    "water_heating_code": 901,
+    "water_heating_fuel": 26,
+    "cylinder_thermostat": "Y",
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 26,
+        "boiler_flue_type": 2,
+        "fan_flue_present": "Y",
+        "heat_emitter_type": 1,
+        "boiler_index_number": 9895,
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_data_source": 1
+      }
+    ],
+    "cylinder_insulation_type": 1,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 50
+  },
+  "sap_version": 9.91,
+  "schema_type": "SAP-Schema-16.3",
+  "uprn_source": "Energy Assessor",
+  "country_code": "EAW",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1 Alexandra House",
+  "address_line_2": "Sealand Drive",
+  "schema_version": "LIG-16.1",
+  "assessment_type": "RdSAP",
+  "completion_date": "2014-02-18",
+  "inspection_date": "2014-02-18",
+  "extensions_count": 0,
+  "measurement_type": 1,
+  "sap_flat_details": {
+    "level": 1,
+    "top_storey": "N",
+    "flat_location": 0,
+    "heat_loss_corridor": 2,
+    "unheated_corridor_length": 10.8
+  },
+  "total_floor_area": 55,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 2,
+  "registration_date": "2014-02-18",
+  "restricted_access": 0,
+  "sap_energy_source": {
+    "main_gas": "Y",
+    "meter_type": 2,
+    "photovoltaic_supply": {
+      "percent_roof_area": 0
+    },
+    "wind_turbines_count": 0,
+    "wind_turbines_terrain_type": 2
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "lzc_energy_sources": [
+    10
+  ],
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 340,
+      "floor_heat_loss": 7,
+      "roof_construction": 3,
+      "wall_construction": 4,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": 2.35,
+          "floor_insulation": 1,
+          "total_floor_area": 55.26,
+          "floor_construction": 1,
+          "heat_loss_perimeter": 29.2
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "K",
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": "ND",
+      "roof_insulation_thickness": "ND"
+    }
+  ],
+  "low_energy_lighting": 80,
+  "solar_water_heating": "Y",
+  "bedf_revision_number": 353,
+  "habitable_room_count": 2,
+  "heating_cost_current": {
+    "value": 231,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.0,
+  "energy_rating_average": 60,
+  "energy_rating_current": 81,
+  "lighting_cost_current": {
+    "value": 47,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "multiple_glazing_type": 2,
+  "open_fireplaces_count": 0,
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 231,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 61,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "co2_emissions_potential": 1.0,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 47,
+    "currency": "GBP"
+  },
+  "hot_water_cost_potential": {
+    "value": 61,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2177,
+    "space_heating_existing_dwelling": 2074
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 99,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": 8.3,
+  "energy_consumption_potential": 99,
+  "environmental_impact_current": 85,
+  "fixed_lighting_outlets_count": 5,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 85,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 19,
+  "low_energy_fixed_lighting_outlets_count": 4
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10013924858/epc.json

@@ -0,0 +1,292 @@
+{
+  "uprn": 10013924858,
+  "roofs": [
+    {
+      "description": "(other premises above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "\u00c2\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "(other premises below)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": "ND",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "ME20 7FH",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "AYLESFORD",
+  "created_at": "2016-06-14 17:29:40.000000",
+  "living_area": 22.2,
+  "orientation": 1,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "thermal_store": 1,
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "has_fghrs": "false",
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": "NA",
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2110,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1.0,
+        "main_heating_flue_type": 5,
+        "central_heating_pump_age": 2,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17863,
+        "has_separate_delayed_start": "false",
+        "is_oil_pump_in_heated_space": "true",
+        "load_or_weather_compensation": 2,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1,
+    "sap_heating_design_water_use": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "\u00c2\u00b3/h.m\u00c2\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "Flat 10 Riverview Court",
+  "address_line_2": "2, Kings Crescent",
+  "assessment_date": "2016-06-14",
+  "assessment_type": "SAP",
+  "completion_date": "2016-06-13",
+  "inspection_date": "2016-06-14",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "air_permeability": 4.96,
+    "open_flues_count": 0,
+    "ventilation_type": 1,
+    "extract_fans_count": 2,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "flueless_gas_fires_count": 0
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.92,
+  "sap_flat_details": {
+    "level": 2
+  },
+  "total_floor_area": 49,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-06-14",
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 25,
+    "low_energy_fixed_lighting_outlets_count": 25,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+      "type": 4,
+      "u_value": 1.2,
+      "data_source": 2,
+      "frame_factor": 0.7,
+      "glazing_type": 3,
+      "solar_transmittance": 0.63
+    },
+    {
+      "name": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+      "type": 4,
+      "u_value": 1.2,
+      "data_source": 2,
+      "glazing_type": 3
+    },
+    {
+      "name": "1 0 Solid Core Door 12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+      "type": 1,
+      "u_value": 1.8,
+      "data_source": 2,
+      "glazing_type": 1
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": 4,
+          "u_value": 0.0,
+          "roof_type": 4,
+          "kappa_value": 20.0,
+          "total_roof_area": 49.1
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "u_value": 0.19,
+          "wall_type": 2,
+          "description": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "kappa_value": 9.0,
+          "total_wall_area": 20.54,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "1 12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+          "u_value": 0.17,
+          "wall_type": 2,
+          "description": "12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+          "kappa_value": 9.0,
+          "total_wall_area": 22.31,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Sealed",
+          "u_value": 0.0,
+          "wall_type": 4,
+          "description": "Sealed",
+          "kappa_value": 20.0,
+          "total_wall_area": 27.03,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "Flat 10 Riverside Court, 2 Kings Crescent, Aylesford, Kent, ME20 7FH",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "type": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "width": 4.5,
+          "height": 1.0,
+          "location": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "orientation": 1
+        },
+        {
+          "name": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "type": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "width": 2.63,
+          "height": 1.0,
+          "location": "Foil Faced Bubble Membrane/12.5 P'bd (Specified U-Value = 0.19)",
+          "orientation": 1
+        },
+        {
+          "name": "1 0 Solid Core Door 12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+          "type": "1 0 Solid Core Door 12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+          "width": 1.95,
+          "height": 1.0,
+          "location": "1 12.5 P'bd/89 Timber Studding Insulated With 60 Mineral Wool/74 Mineral Wool/89 Timber Studding Insulated With 60 Mineral Wool/12.5 P'bd",
+          "orientation": 0
+        }
+      ],
+      "construction_year": 2016,
+      "sap_thermal_bridges": {
+        "thermal_bridge_code": 4,
+        "user_defined_y_value": 0.065,
+        "calculation_reference": 1
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 3,
+          "u_value": 0.0,
+          "floor_type": 3,
+          "kappa_value": 30.0,
+          "storey_height": 0.0,
+          "heat_loss_area": 0.0,
+          "total_floor_area": 49.1,
+          "kappa_value_from_below": 0.0
+        }
+      ]
+    }
+  ],
+  "heating_cost_current": 146,
+  "co2_emissions_current": 0.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 84,
+  "lighting_cost_current": 41,
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": 146,
+  "hot_water_cost_current": 68,
+  "co2_emissions_potential": 0.7,
+  "energy_rating_potential": 84,
+  "lighting_cost_potential": 41,
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": 68,
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 857,
+      "water_heating": 1384
+    }
+  },
+  "seller_commission_report": "N",
+  "energy_consumption_current": 83,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": "6.03b1",
+  "energy_consumption_potential": 83,
+  "environmental_impact_current": 89,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 15,
+  "additional_allowable_electricity_generation": 0.0
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10023443568/epc.json

@@ -0,0 +1,362 @@
+{
+  "uprn": 10023443568,
+  "roofs": [
+    {
+      "description": "(other premises above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.26 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "(other premises below)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 1,
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 5UN",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "built_form": 1,
+  "created_at": "2016-04-21 10:57:07",
+  "living_area": 23.6,
+  "orientation": 0,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "thermal_store": 1,
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "central_heating_pump_age": 2,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17045,
+        "has_separate_delayed_start": "true",
+        "load_or_weather_compensation": 4,
+        "compensating_controller_index_number": 696322,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 4.7 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "10, Central Road",
+  "assessment_date": "2016-04-20",
+  "assessment_type": "SAP",
+  "completion_date": "2016-04-21",
+  "inspection_date": "2016-04-20",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "air_permeability": 4.66,
+    "open_flues_count": 0,
+    "ventilation_type": 1,
+    "extract_fans_count": 2,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "flueless_gas_fires_count": 0
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.9,
+  "sap_flat_details": {
+    "level": 2
+  },
+  "total_floor_area": 63,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-04-21",
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 8,
+    "low_energy_fixed_lighting_outlets_count": 8,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": 1,
+      "type": 4,
+      "u_value": 1.41,
+      "data_source": 2,
+      "description": "W1 B2",
+      "frame_factor": 0.7,
+      "glazing_type": 6,
+      "solar_transmittance": 0.71
+    },
+    {
+      "name": 2,
+      "type": 2,
+      "u_value": 1.7,
+      "data_source": 2,
+      "description": "D1 W",
+      "glazing_type": 6
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_walls": [
+        {
+          "name": "Wall 1",
+          "u_value": 0.29,
+          "wall_type": 2,
+          "description": "Exposed Wall",
+          "total_wall_area": 39.19,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 5",
+          "u_value": 0.23,
+          "wall_type": 3,
+          "description": "Lift shaft",
+          "total_wall_area": 5.9,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 2",
+          "u_value": 0,
+          "wall_type": 4,
+          "description": "Party Wall",
+          "total_wall_area": 20.88
+        },
+        {
+          "name": "Wall 3",
+          "u_value": 0.22,
+          "wall_type": 3,
+          "description": "Semi Exposed Corr",
+          "total_wall_area": 6.02,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 4",
+          "u_value": 0.2,
+          "wall_type": 3,
+          "description": "Stairwell",
+          "total_wall_area": 6.14,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": 1,
+          "width": 1.02,
+          "height": 2.1,
+          "location": "Wall 1",
+          "orientation": 7
+        },
+        {
+          "name": 2,
+          "type": 2,
+          "width": 0.93,
+          "height": 2.1,
+          "location": "Wall 3",
+          "orientation": 0
+        },
+        {
+          "name": 3,
+          "type": 1,
+          "width": 2.37,
+          "height": 1.05,
+          "location": "Wall 1",
+          "orientation": 7
+        },
+        {
+          "name": 4,
+          "type": 1,
+          "width": 1.81,
+          "height": 2.1,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 5,
+          "type": 1,
+          "width": 1.02,
+          "height": 2.1,
+          "location": "Wall 1",
+          "orientation": 1
+        }
+      ],
+      "construction_year": 2015,
+      "sap_thermal_bridges": {
+        "thermal_bridges": [
+          {
+            "length": 7.15,
+            "psi_value": 0.054,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E2"
+          },
+          {
+            "length": 7.15,
+            "psi_value": 0.034,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E3"
+          },
+          {
+            "length": 18.9,
+            "psi_value": 0.039,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E4"
+          },
+          {
+            "length": 46.6,
+            "psi_value": 0.086,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E7"
+          },
+          {
+            "length": 4.91,
+            "psi_value": 0.056,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E16"
+          },
+          {
+            "length": 4.91,
+            "psi_value": 0.044,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E18"
+          },
+          {
+            "length": 17,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P3"
+          }
+        ],
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 1,
+          "u_value": 0,
+          "floor_type": 4,
+          "storey_height": 2.42,
+          "heat_loss_area": 0,
+          "total_floor_area": 63.4
+        }
+      ],
+      "thermal_mass_parameter": 250
+    }
+  ],
+  "heating_cost_current": {
+    "value": 165,
+    "currency": "GBP"
+  },
+  "co2_emissions_current": 0.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 84,
+  "lighting_cost_current": {
+    "value": 45,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 165,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 79,
+    "currency": "GBP"
+  },
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 84,
+  "lighting_cost_potential": {
+    "value": 45,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 79,
+    "currency": "GBP"
+  },
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 1218,
+      "water_heating": 1615
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 79,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": 6.2,
+  "energy_consumption_potential": 79,
+  "environmental_impact_current": 88,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 88,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 14
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10023444170/epc.json

@@ -0,0 +1,487 @@
+{
+  "uprn": 10023444170,
+  "roofs": [
+    {
+      "description": "(other premises above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.25 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.17 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "tenure": "ND",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 1UN",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "created_at": "2016-05-16 10:27:21",
+  "living_area": 22.3,
+  "orientation": 3,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "central_heating_pump_age": 1,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17615,
+        "has_separate_delayed_start": "false",
+        "load_or_weather_compensation": 4,
+        "compensating_controller_index_number": 200006,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1,
+    "sap_heating_design_water_use": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 5.2 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1 Jackson Mews",
+  "address_line_2": "21, Fulwich Road",
+  "assessment_date": "2016-05-16",
+  "assessment_type": "SAP",
+  "completion_date": "2016-05-16",
+  "inspection_date": "2016-05-16",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "wet_rooms_count": 2,
+    "air_permeability": 5.22,
+    "open_flues_count": 0,
+    "ventilation_type": 8,
+    "extract_fans_count": 0,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 4,
+    "flueless_gas_fires_count": 0,
+    "mechanical_vent_duct_type": 2,
+    "mechanical_vent_duct_insulation": 2,
+    "mechanical_ventilation_data_source": 1,
+    "mechanical_vent_system_index_number": 500167,
+    "is_mechanical_vent_approved_installer_scheme": "true"
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.92,
+  "sap_flat_details": {
+    "level": 1
+  },
+  "total_floor_area": 60,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-05-16",
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 5,
+    "low_energy_fixed_lighting_outlets_count": 5,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "Door (1)",
+      "type": 1,
+      "u_value": 1.3,
+      "data_source": 2,
+      "description": "Data from Manufacturer",
+      "glazing_type": 1
+    },
+    {
+      "name": "Windows (1)",
+      "type": 4,
+      "u_value": 1.4,
+      "data_source": 2,
+      "description": "Data from Manufacturer",
+      "frame_factor": 0.85,
+      "glazing_type": 4,
+      "solar_transmittance": 0.63
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "Exposed Roof",
+          "u_value": 0,
+          "roof_type": 2,
+          "kappa_value": 0,
+          "total_roof_area": 0
+        },
+        {
+          "name": "Party Ceiling",
+          "u_value": 0,
+          "roof_type": 4,
+          "kappa_value": 30,
+          "total_roof_area": 60.1
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "Ext Wall",
+          "u_value": 0.25,
+          "wall_type": 2,
+          "kappa_value": 190,
+          "total_wall_area": 54.7,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Adj Circ",
+          "u_value": 0.25,
+          "wall_type": 2,
+          "kappa_value": 190,
+          "total_wall_area": 5.1,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Int Walls",
+          "u_value": 0,
+          "wall_type": 5,
+          "kappa_value": 9,
+          "total_wall_area": 123.4
+        },
+        {
+          "name": "Party Wall",
+          "u_value": 0,
+          "wall_type": 4,
+          "kappa_value": 180,
+          "total_wall_area": 17.3
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": "Door (1)",
+          "width": 0.97,
+          "height": 2.1,
+          "location": "Adj Circ",
+          "orientation": 3
+        },
+        {
+          "name": 2,
+          "type": "Windows (1)",
+          "width": 1.44,
+          "height": 2.1,
+          "location": "Ext Wall",
+          "orientation": 1
+        },
+        {
+          "name": 3,
+          "type": "Windows (1)",
+          "width": 0.66,
+          "height": 1.9,
+          "location": "Ext Wall",
+          "orientation": 1
+        },
+        {
+          "name": 4,
+          "type": "Windows (1)",
+          "width": 1.19,
+          "height": 1.21,
+          "location": "Ext Wall",
+          "orientation": 1
+        },
+        {
+          "name": 5,
+          "type": "Windows (1)",
+          "width": 1.2,
+          "height": 0.91,
+          "location": "Ext Wall",
+          "orientation": 7
+        },
+        {
+          "name": 6,
+          "type": "Windows (1)",
+          "width": 1.22,
+          "height": 1.2,
+          "location": "Ext Wall",
+          "orientation": 5
+        },
+        {
+          "name": 7,
+          "type": "Windows (1)",
+          "width": 0.91,
+          "height": 1.2,
+          "location": "Ext Wall",
+          "orientation": 5
+        }
+      ],
+      "construction_year": 2015,
+      "sap_thermal_bridges": {
+        "thermal_bridges": [
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E1"
+          },
+          {
+            "length": 7.59,
+            "psi_value": 0.3,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E2"
+          },
+          {
+            "length": 5.47,
+            "psi_value": 0.04,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E3"
+          },
+          {
+            "length": 21.24,
+            "psi_value": 0.05,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E4"
+          },
+          {
+            "length": 22.7,
+            "psi_value": 0.16,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E5"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E6"
+          },
+          {
+            "length": 22.7,
+            "psi_value": 0.07,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E7"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E8"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E9"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E10"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E11"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E12"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E13"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E14"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E15"
+          },
+          {
+            "length": 7.23,
+            "psi_value": 0.09,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E16"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E17"
+          },
+          {
+            "length": 2.41,
+            "psi_value": 0.06,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E18"
+          },
+          {
+            "length": 7.19,
+            "psi_value": 0.08,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P1"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P2"
+          },
+          {
+            "length": 7.19,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P3"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P4"
+          },
+          {
+            "length": 0,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P5"
+          }
+        ],
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.17,
+          "floor_type": 2,
+          "kappa_value": 75,
+          "storey_height": 2.41,
+          "heat_loss_area": 60.1,
+          "total_floor_area": 60.1
+        }
+      ]
+    }
+  ],
+  "heating_cost_current": {
+    "value": 190,
+    "currency": "GBP"
+  },
+  "co2_emissions_current": 0.9,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": {
+    "value": 42,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 190,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 76,
+    "currency": "GBP"
+  },
+  "co2_emissions_potential": 0.9,
+  "energy_rating_potential": 83,
+  "lighting_cost_potential": {
+    "value": 42,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 76,
+    "currency": "GBP"
+  },
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 1121,
+      "water_heating": 1533
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 88,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": "Version: 1.0.3.4",
+  "energy_consumption_potential": 88,
+  "environmental_impact_current": 87,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 87,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 15
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10023444320/epc.json

@@ -0,0 +1,364 @@
+{
+  "uprn": 10023444320,
+  "roofs": [
+    {
+      "description": "(other premises above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.2 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.2 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "tenure": "ND",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 5UU",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "built_form": 1,
+  "created_at": "2016-09-06 16:02:50",
+  "living_area": 21.45,
+  "orientation": 0,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "thermal_store": 1,
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "central_heating_pump_age": 2,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 16211,
+        "has_separate_delayed_start": "true",
+        "load_or_weather_compensation": 0,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 3.1 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Mid-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "10, Ashmore Close",
+  "assessment_date": "2016-09-06",
+  "assessment_type": "SAP",
+  "completion_date": "2016-09-06",
+  "inspection_date": "2016-09-06",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "wet_rooms_count": 2,
+    "air_permeability": 3.09,
+    "open_flues_count": 0,
+    "ventilation_type": 6,
+    "extract_fans_count": 0,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "kitchen_duct_fans_count": 0,
+    "kitchen_room_fans_count": 1,
+    "kitchen_wall_fans_count": 0,
+    "flueless_gas_fires_count": 0,
+    "mechanical_vent_duct_type": 2,
+    "non_kitchen_duct_fans_count": 0,
+    "non_kitchen_room_fans_count": 1,
+    "non_kitchen_wall_fans_count": 0,
+    "mechanical_ventilation_data_source": 1,
+    "mechanical_vent_system_index_number": 500416,
+    "is_mechanical_vent_approved_installer_scheme": "true"
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.92,
+  "sap_flat_details": {
+    "level": 2
+  },
+  "total_floor_area": 51,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-09-06",
+  "sap_energy_source": {
+    "pv_arrays": [
+      {
+        "pitch": 2,
+        "peak_power": 0.48,
+        "orientation": 5,
+        "overshading": 1,
+        "pv_connection": 1
+      }
+    ],
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 6,
+    "low_energy_fixed_lighting_outlets_count": 6,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": 1,
+      "type": 1,
+      "u_value": 0.97,
+      "data_source": 2,
+      "description": "Front",
+      "glazing_type": 1
+    },
+    {
+      "name": 2,
+      "type": 4,
+      "u_value": 1.2,
+      "data_source": 2,
+      "description": "Window",
+      "frame_factor": 0.7,
+      "glazing_type": 6,
+      "solar_transmittance": 0.63
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "lzc_energy_sources": [
+    11
+  ],
+  "sap_building_parts": [
+    {
+      "sap_walls": [
+        {
+          "name": "Wall 1",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "150mm hi-cav 32 AAC",
+          "total_wall_area": 53.26,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 2",
+          "u_value": 0.18,
+          "wall_type": 3,
+          "description": "To corridor",
+          "total_wall_area": 15.18,
+          "is_curtain_walling": "false"
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": 1,
+          "width": 1,
+          "height": 2.1,
+          "location": "Wall 2",
+          "orientation": 0
+        },
+        {
+          "name": 2,
+          "type": 2,
+          "width": 1.17,
+          "height": 2.29,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 3,
+          "type": 2,
+          "width": 1.17,
+          "height": 2.29,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 4,
+          "type": 2,
+          "width": 2.29,
+          "height": 2.29,
+          "location": "Wall 1",
+          "orientation": 5
+        },
+        {
+          "name": 5,
+          "type": 2,
+          "width": 1.18,
+          "height": 1.38,
+          "location": "Wall 1",
+          "orientation": 1
+        },
+        {
+          "name": 6,
+          "type": 2,
+          "width": 1.18,
+          "height": 1.38,
+          "location": "Wall 1",
+          "orientation": 1
+        }
+      ],
+      "construction_year": 2015,
+      "sap_thermal_bridges": {
+        "thermal_bridges": [
+          {
+            "length": 7.99,
+            "psi_value": 0.3,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E2"
+          },
+          {
+            "length": 6.99,
+            "psi_value": 0.04,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E3"
+          },
+          {
+            "length": 23.46,
+            "psi_value": 0.05,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E4"
+          },
+          {
+            "length": 28.39,
+            "psi_value": 0.32,
+            "psi_value_source": 4,
+            "thermal_bridge_type": "E20"
+          },
+          {
+            "length": 2.41,
+            "psi_value": 1,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E9"
+          },
+          {
+            "length": 9.64,
+            "psi_value": 0.09,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E16"
+          }
+        ],
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 1,
+          "u_value": 0.18,
+          "floor_type": 4,
+          "description": "Floor abv Bike Store",
+          "storey_height": 2.41,
+          "heat_loss_area": 50.68,
+          "total_floor_area": 50.68
+        }
+      ],
+      "thermal_mass_parameter": 250
+    }
+  ],
+  "heating_cost_current": {
+    "value": 182,
+    "currency": "GBP"
+  },
+  "co2_emissions_current": 0.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 81,
+  "lighting_cost_current": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 182,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "co2_emissions_potential": 0.7,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 1525,
+      "water_heating": 1657
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 80,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": 6.2,
+  "energy_consumption_potential": 80,
+  "environmental_impact_current": 89,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 14
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10023444324/epc.json

@@ -0,0 +1,387 @@
+{
+  "uprn": 10023444324,
+  "roofs": [
+    {
+      "description": "(other premises above)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.2 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.1 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "tenure": "ND",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "DA1 5UU",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "DARTFORD",
+  "built_form": 3,
+  "created_at": "2016-09-06 16:02:00",
+  "living_area": 25.23,
+  "orientation": 0,
+  "region_code": 14,
+  "report_type": 3,
+  "sap_heating": {
+    "thermal_store": 1,
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2106,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "central_heating_pump_age": 2,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 16211,
+        "has_separate_delayed_start": "true",
+        "load_or_weather_compensation": 0,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 3.2 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Ground-floor flat",
+  "language_code": 1,
+  "property_type": 2,
+  "address_line_1": "1, Ashmore Close",
+  "assessment_date": "2016-09-06",
+  "assessment_type": "SAP",
+  "completion_date": "2016-09-06",
+  "inspection_date": "2016-09-06",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "wet_rooms_count": 2,
+    "air_permeability": 3.24,
+    "open_flues_count": 0,
+    "ventilation_type": 6,
+    "extract_fans_count": 0,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "kitchen_duct_fans_count": 0,
+    "kitchen_room_fans_count": 1,
+    "kitchen_wall_fans_count": 0,
+    "flueless_gas_fires_count": 0,
+    "mechanical_vent_duct_type": 2,
+    "non_kitchen_duct_fans_count": 0,
+    "non_kitchen_room_fans_count": 1,
+    "non_kitchen_wall_fans_count": 0,
+    "mechanical_ventilation_data_source": 1,
+    "mechanical_vent_system_index_number": 500416,
+    "is_mechanical_vent_approved_installer_scheme": "true"
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.92,
+  "sap_flat_details": {
+    "level": 1
+  },
+  "total_floor_area": 50,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-09-06",
+  "sap_energy_source": {
+    "pv_arrays": [
+      {
+        "pitch": 2,
+        "peak_power": 0.48,
+        "orientation": 5,
+        "overshading": 1,
+        "pv_connection": 1
+      }
+    ],
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 6,
+    "low_energy_fixed_lighting_outlets_count": 6,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": 1,
+      "type": 1,
+      "u_value": 0.97,
+      "data_source": 2,
+      "description": "Front",
+      "glazing_type": 1
+    },
+    {
+      "name": 2,
+      "type": 4,
+      "u_value": 1.2,
+      "data_source": 2,
+      "description": "Window",
+      "frame_factor": 0.7,
+      "glazing_type": 6,
+      "solar_transmittance": 0.63
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "lzc_energy_sources": [
+    11
+  ],
+  "sap_building_parts": [
+    {
+      "sap_walls": [
+        {
+          "name": "Wall 1",
+          "u_value": 0.2,
+          "wall_type": 2,
+          "description": "150mm hi-cav 32 AAC",
+          "total_wall_area": 37.93,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 2",
+          "u_value": 0.18,
+          "wall_type": 3,
+          "description": "To corridor",
+          "total_wall_area": 19.28,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Wall 3",
+          "u_value": 0,
+          "wall_type": 4,
+          "description": "party",
+          "total_wall_area": 15.5
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": 1,
+          "width": 1,
+          "height": 2.1,
+          "location": "Wall 2",
+          "orientation": 0
+        },
+        {
+          "name": 2,
+          "type": 2,
+          "width": 1.16,
+          "height": 2.28,
+          "location": "Wall 1",
+          "orientation": 7
+        },
+        {
+          "name": 3,
+          "type": 2,
+          "width": 1.16,
+          "height": 1.08,
+          "location": "Wall 1",
+          "orientation": 7
+        },
+        {
+          "name": 4,
+          "type": 2,
+          "width": 2.29,
+          "height": 2.28,
+          "location": "Wall 1",
+          "orientation": 7
+        },
+        {
+          "name": 5,
+          "type": 2,
+          "width": 1.17,
+          "height": 2.23,
+          "location": "Wall 1",
+          "orientation": 3
+        }
+      ],
+      "construction_year": 2015,
+      "sap_thermal_bridges": {
+        "thermal_bridges": [
+          {
+            "length": 6.78,
+            "psi_value": 0.3,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E2"
+          },
+          {
+            "length": 5.78,
+            "psi_value": 0.04,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E3"
+          },
+          {
+            "length": 19.94,
+            "psi_value": 0.05,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E4"
+          },
+          {
+            "length": 22.17,
+            "psi_value": 0.16,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E5"
+          },
+          {
+            "length": 22.17,
+            "psi_value": 0.07,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E7"
+          },
+          {
+            "length": 2.26,
+            "psi_value": 1,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "E9"
+          },
+          {
+            "length": 4.82,
+            "psi_value": 0.09,
+            "psi_value_source": 2,
+            "thermal_bridge_type": "E16"
+          },
+          {
+            "length": 4.82,
+            "psi_value": 0.12,
+            "psi_value_source": 4,
+            "thermal_bridge_type": "E18"
+          },
+          {
+            "length": 8,
+            "psi_value": 0.16,
+            "psi_value_source": 4,
+            "thermal_bridge_type": "P1"
+          },
+          {
+            "length": 8,
+            "psi_value": 0,
+            "psi_value_source": 3,
+            "thermal_bridge_type": "P3"
+          }
+        ],
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.1,
+          "floor_type": 2,
+          "description": "Floor 1",
+          "storey_height": 2.41,
+          "heat_loss_area": 50.17,
+          "total_floor_area": 50.17
+        }
+      ],
+      "thermal_mass_parameter": 250
+    }
+  ],
+  "heating_cost_current": {
+    "value": 171,
+    "currency": "GBP"
+  },
+  "co2_emissions_current": 0.7,
+  "energy_rating_average": 60,
+  "energy_rating_current": 82,
+  "lighting_cost_current": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer, room thermostat and TRVs",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 171,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "co2_emissions_potential": 0.7,
+  "energy_rating_potential": 82,
+  "lighting_cost_potential": {
+    "value": 36,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 80,
+    "currency": "GBP"
+  },
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 1299,
+      "water_heating": 1651
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 75,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": 6.2,
+  "energy_consumption_potential": 75,
+  "environmental_impact_current": 89,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 89,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 13
+}

backend/epc_api/json_samples/real_life_examples/SAP-Schema-17.0/uprn_10090034761/epc.json

@@ -0,0 +1,342 @@
+{
+  "uprn": 10090034761,
+  "roofs": [
+    {
+      "description": "Average thermal transmittance 0.11 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "walls": [
+    {
+      "description": "Average thermal transmittance 0.25 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "floors": [
+    {
+      "description": "Average thermal transmittance 0.15 W/m\u00b2K",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "status": "entered",
+  "tenure": "ND",
+  "windows": {
+    "description": "High performance glazing",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "lighting": {
+    "description": "Low energy lighting in all fixed outlets",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "BN13 3GE",
+  "data_type": 2,
+  "hot_water": {
+    "description": "From main system",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "post_town": "WORTHING",
+  "created_at": "2016-10-03 15:14:08",
+  "living_area": 15.1,
+  "orientation": 8,
+  "region_code": 16,
+  "report_type": 3,
+  "sap_heating": {
+    "water_fuel_type": 1,
+    "water_heating_code": 901,
+    "main_heating_details": [
+      {
+        "main_fuel_type": 1,
+        "heat_emitter_type": 1,
+        "emitter_temperature": 1,
+        "is_flue_fan_present": "true",
+        "main_heating_number": 1,
+        "main_heating_control": 2110,
+        "is_interlocked_system": "true",
+        "main_heating_category": 2,
+        "main_heating_fraction": 1,
+        "main_heating_flue_type": 2,
+        "central_heating_pump_age": 1,
+        "main_heating_data_source": 1,
+        "main_heating_index_number": 17045,
+        "has_separate_delayed_start": "true",
+        "load_or_weather_compensation": 0,
+        "is_central_heating_pump_in_heated_space": "true"
+      }
+    ],
+    "has_hot_water_cylinder": "false",
+    "has_fixed_air_conditioning": "false",
+    "secondary_heating_category": 1,
+    "sap_heating_design_water_use": 1
+  },
+  "sap_version": 9.92,
+  "schema_type": "SAP-Schema-17.0",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Boiler and radiators, mains gas",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "air_tightness": {
+    "description": "Air permeability 3.0 m\u00b3/h.m\u00b2 (as tested)",
+    "energy_efficiency_rating": 4,
+    "environmental_efficiency_rating": 4
+  },
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "property_type": 0,
+  "address_line_1": "10, Oaksheath Gardens",
+  "assessment_date": "2016-10-03",
+  "assessment_type": "SAP",
+  "completion_date": "2016-10-03",
+  "inspection_date": "2016-10-03",
+  "sap_ventilation": {
+    "psv_count": 0,
+    "pressure_test": 1,
+    "wet_rooms_count": 5,
+    "air_permeability": 3.038,
+    "open_flues_count": 0,
+    "ventilation_type": 6,
+    "extract_fans_count": 0,
+    "open_fireplaces_count": 0,
+    "sheltered_sides_count": 2,
+    "kitchen_duct_fans_count": 0,
+    "kitchen_room_fans_count": 1,
+    "kitchen_wall_fans_count": 0,
+    "flueless_gas_fires_count": 0,
+    "mechanical_vent_duct_type": 1,
+    "non_kitchen_duct_fans_count": 0,
+    "non_kitchen_room_fans_count": 4,
+    "non_kitchen_wall_fans_count": 0,
+    "mechanical_ventilation_data_source": 1,
+    "mechanical_vent_system_index_number": 500230,
+    "is_mechanical_vent_approved_installer_scheme": "true"
+  },
+  "design_water_use": 1,
+  "sap_data_version": 9.92,
+  "total_floor_area": 74,
+  "transaction_type": 6,
+  "conservatory_type": 1,
+  "registration_date": "2016-10-03",
+  "sap_energy_source": {
+    "electricity_tariff": 1,
+    "wind_turbines_count": 0,
+    "wind_turbine_terrain_type": 2,
+    "fixed_lighting_outlets_count": 1,
+    "low_energy_fixed_lighting_outlets_count": 1,
+    "low_energy_fixed_lighting_outlets_percentage": 100
+  },
+  "sap_opening_types": [
+    {
+      "name": "Door (1)",
+      "type": 1,
+      "u_value": 1.5,
+      "data_source": 2,
+      "description": "Data from Manufacturer",
+      "glazing_type": 1
+    },
+    {
+      "name": "Windows (1)",
+      "type": 4,
+      "u_value": 1.2,
+      "frame_type": 2,
+      "data_source": 2,
+      "description": "Data from Manufacturer",
+      "frame_factor": 0.7,
+      "glazing_type": 7,
+      "solar_transmittance": 0.71
+    }
+  ],
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "sap_building_parts": [
+    {
+      "sap_roofs": [
+        {
+          "name": "Cold",
+          "u_value": 0.11,
+          "roof_type": 2,
+          "kappa_value": 9,
+          "total_roof_area": 36.8
+        }
+      ],
+      "sap_walls": [
+        {
+          "name": "External",
+          "u_value": 0.25,
+          "wall_type": 2,
+          "kappa_value": 60,
+          "total_wall_area": 46.8,
+          "is_curtain_walling": "false"
+        },
+        {
+          "name": "Party Wall",
+          "u_value": 0,
+          "wall_type": 4,
+          "kappa_value": 45,
+          "total_wall_area": 75.4
+        }
+      ],
+      "identifier": "Main Dwelling",
+      "overshading": 2,
+      "sap_openings": [
+        {
+          "name": 1,
+          "type": "Door (1)",
+          "width": 0,
+          "height": 0,
+          "location": "External",
+          "orientation": 8
+        },
+        {
+          "name": 2,
+          "type": "Door (1)",
+          "width": 0,
+          "height": 0,
+          "location": "External",
+          "orientation": 4
+        },
+        {
+          "name": 3,
+          "type": "Windows (1)",
+          "width": 0,
+          "height": 0,
+          "location": "External",
+          "orientation": 8
+        },
+        {
+          "name": 4,
+          "type": "Windows (1)",
+          "width": 0,
+          "height": 0,
+          "location": "External",
+          "orientation": 4
+        }
+      ],
+      "construction_year": 2016,
+      "sap_thermal_bridges": {
+        "thermal_bridge_code": 5
+      },
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "storey": 0,
+          "u_value": 0.15,
+          "floor_type": 2,
+          "kappa_value": 75,
+          "storey_height": 2.4,
+          "heat_loss_area": 36.8,
+          "total_floor_area": 36.8
+        },
+        {
+          "storey": 1,
+          "u_value": 0,
+          "floor_type": 3,
+          "storey_height": 2.6,
+          "heat_loss_area": 0,
+          "total_floor_area": 36.8
+        }
+      ]
+    }
+  ],
+  "heating_cost_current": {
+    "value": 214,
+    "currency": "GBP"
+  },
+  "co2_emissions_current": 1.2,
+  "energy_rating_average": 60,
+  "energy_rating_current": 83,
+  "lighting_cost_current": {
+    "value": 55,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Time and temperature zone control",
+      "energy_efficiency_rating": 5,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "has_hot_water_cylinder": "false",
+  "heating_cost_potential": {
+    "value": 214,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 83,
+    "currency": "GBP"
+  },
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 34,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a34,000 - \u00a36,000",
+      "improvement_type": "N",
+      "improvement_details": {
+        "improvement_number": 19
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 85,
+      "environmental_impact_rating": 89
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 303,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a38,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 96,
+      "environmental_impact_rating": 99
+    }
+  ],
+  "co2_emissions_potential": 0.0,
+  "energy_rating_potential": 96,
+  "lighting_cost_potential": {
+    "value": 55,
+    "currency": "GBP"
+  },
+  "schema_version_original": "LIG-17.0",
+  "hot_water_cost_potential": {
+    "value": 49,
+    "currency": "GBP"
+  },
+  "is_in_smoke_control_area": "unknown",
+  "renewable_heat_incentive": {
+    "rhi_new_dwelling": {
+      "space_heating": 1824,
+      "water_heating": 1712
+    }
+  },
+  "seller_commission_report": "Y",
+  "energy_consumption_current": 90,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_percentage": 100,
+  "calculation_software_version": "Version: 1.0.3.13",
+  "energy_consumption_potential": -6,
+  "environmental_impact_current": 87,
+  "current_energy_efficiency_band": "B",
+  "environmental_impact_potential": 99,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "A",
+  "co2_emissions_current_per_floor_area": 16
+}