@vepler/sdk 3.3.0 → 6.0.0

package/src/sdk/models/shared/epcqueryresponse.ts

@@ -11,41 +11,41 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * Standardised address.
+ * The certificate's address, in the same form as the rest of the API.
  */
 export type EPCQueryResponseAddress = {
   /**
-   * Formatted display address.
+   * The address formatted as a single line, ready to show to an end user.
    */
   displayAddress: string;
   /**
-   * Address line 1.
+   * First line of the address.
    */
   line1: string | null;
   /**
-   * Address line 2.
+   * Second line of the address, where there is one.
    */
   line2: string | null;
   /**
-   * Address line 3 / post town.
+   * Third line of the address. Scottish certificates carry the post town here.
    */
   line3: string | null;
   /**
-   * Post town.
+   * The post town.
    */
   postTown: string | null;
   /**
-   * UK postcode.
+   * The full UK postcode.
    */
   postcode: string;
   /**
-   * Postcode with spaces removed, for matching.
+   * The same postcode with the space removed, for matching.
    */
   postcodeNoSpace: string;
 };
 
 /**
- * Assessment methodology: rdsap (existing domestic), sap (new domestic), sbem (non-domestic), dsm (complex non-domestic), operational (DEC).
+ * Which procedure the assessment followed. `rdsap` is the reduced-data procedure for existing dwellings and `sap` the full procedure for new ones; `sbem` covers non-domestic buildings and `dsm` the dynamic simulation modelling used for the most complex of them; `operational` is the metered assessment behind a Display Energy Certificate.
  */
 export const AssessmentMethodology = {
   Rdsap: "rdsap",
@@ -55,12 +55,12 @@ export const AssessmentMethodology = {
   Operational: "operational",
 } as const;
 /**
- * Assessment methodology: rdsap (existing domestic), sap (new domestic), sbem (non-domestic), dsm (complex non-domestic), operational (DEC).
+ * Which procedure the assessment followed. `rdsap` is the reduced-data procedure for existing dwellings and `sap` the full procedure for new ones; `sbem` covers non-domestic buildings and `dsm` the dynamic simulation modelling used for the most complex of them; `operational` is the metered assessment behind a Display Energy Certificate.
  */
 export type AssessmentMethodology = OpenEnum<typeof AssessmentMethodology>;
 
 /**
- * Primary servicing strategy for CO2 emissions calculation.
+ * How the building is serviced for heating, ventilation and cooling, which sets the basis for its emissions calculation.
  */
 export const BuildingEnvironment = {
   HeatingAndNaturalVentilation: "heating_and_natural_ventilation",
@@ -71,12 +71,12 @@ export const BuildingEnvironment = {
   Unconditioned: "unconditioned",
 } as const;
 /**
- * Primary servicing strategy for CO2 emissions calculation.
+ * How the building is serviced for heating, ventilation and cooling, which sets the basis for its emissions calculation.
  */
 export type BuildingEnvironment = OpenEnum<typeof BuildingEnvironment>;
 
 /**
- * New build benchmark band. Scotland only.
+ * Band for the new build benchmark. Scotland only.
  */
 export const NewBuildBand = {
   APlus: "A+",
@@ -94,66 +94,66 @@ export const NewBuildBand = {
   G: "G",
 } as const;
 /**
- * New build benchmark band. Scotland only.
+ * Band for the new build benchmark. Scotland only.
  */
 export type NewBuildBand = OpenEnum<typeof NewBuildBand>;
 
 /**
- * Non-domestic benchmarks and building classification. Null for domestic.
+ * Benchmarks and complexity classification for non-domestic buildings. Null on domestic certificates.
  */
 export type Benchmarks = {
   /**
-   * Total energy use minus on-site generation (kWh/m²/year). Scotland only.
+   * Total energy use less on-site generation, in kWh per m² per year. Scotland only.
    */
   approximateEnergyUse: number | null;
   /**
-   * Building Emission Rate — actual annual CO2 output (kg CO2/m²/year).
+   * Building Emission Rate: the building's own annual emissions, in kg CO2 per m² per year.
    */
   buildingEmissions: number | null;
   /**
-   * Primary servicing strategy for CO2 emissions calculation.
+   * How the building is serviced for heating, ventilation and cooling, which sets the basis for its emissions calculation.
    */
   buildingEnvironment: BuildingEnvironment | null;
   /**
-   * NOS assessor complexity classification. 3=simple (small, naturally ventilated), 4=medium (sophisticated HVAC), 5=complex (DSM required — airports, large shopping centres). E&W only.
+   * How complex the building is to assess, from 3 to 5. Level 3 covers small, naturally ventilated buildings, level 4 those with more sophisticated heating and cooling, and level 5 the most complex, such as airports and large shopping centres, which need dynamic simulation modelling. England and Wales only.
    */
   buildingLevel: number | null;
   /**
-   * Electricity source (grid vs other). Scotland only. In practice, 100% of records report 'Grid supplied'.
+   * Where the building's electricity comes from. Scotland only.
    */
   electricitySource: string | null;
   /**
-   * Existing stock benchmark. E&W only (EXISTING_STOCK_BENCHMARK).
+   * The benchmark for typical existing stock. England and Wales only.
    */
   existingStock: string | null;
   /**
-   * Whether the building meets 2002 Scottish Building Standards (Section 63). Scotland only.
+   * True when the building meets the 2002 Scottish building standards. Scotland only.
    */
   meets2002Standard: boolean | null;
   /**
-   * New build benchmark rating. E&W: text value from NEW_BUILD_BENCHMARK. Scotland: numeric kg CO2/m²/year from NEW_BUILD_ENERGY_PERFORMANCE_RATING.
+   * The benchmark rating an equivalent new building would achieve. On Scottish certificates this is in kg CO2 per m² per year.
    */
   newBuild: number | null;
   /**
-   * New build benchmark band. Scotland only.
+   * Band for the new build benchmark. Scotland only.
    */
   newBuildBand: NewBuildBand | null;
   /**
-   * Standard Emission Rate — fixed improvement-adjusted baseline (kg CO2/m²/year). E&W only.
+   * Standard Emission Rate: the improvement-adjusted baseline the building is measured against, in kg CO2 per m² per year. England and Wales only.
    */
   standardEmissions: number | null;
   /**
-   * Target Emission Rate — Building Regs minimum requirement (kg CO2/m²/year).
+   * Target Emission Rate: the emissions the Building Regulations require of this building, in kg CO2 per m² per year.
    */
   targetEmissions: number | null;
   /**
-   * Typical Emission Rate — industry comparison baseline (kg CO2/m²/year). E&W only.
+   * Typical Emission Rate: the industry comparison baseline, in kg CO2 per m² per year. England and Wales only.
    */
   typicalEmissions: number | null;
 };
 
 /**
- * Certificate type: domestic, non_domestic, or dec.
+ * What kind of certificate this is. `domestic` and `non_domestic` are Energy Performance Certificates for dwellings and for other buildings; `dec` is a Display Energy Certificate, which rates a public building's measured energy use.
  */
 export const EPCQueryResponseCertificateType = {
   Domestic: "domestic",
@@ -161,28 +161,28 @@ export const EPCQueryResponseCertificateType = {
   Dec: "dec",
 } as const;
 /**
- * Certificate type: domestic, non_domestic, or dec.
+ * What kind of certificate this is. `domestic` and `non_domestic` are Energy Performance Certificates for dwellings and for other buildings; `dec` is a Display Energy Certificate, which rates a public building's measured energy use.
  */
 export type EPCQueryResponseCertificateType = OpenEnum<
   typeof EPCQueryResponseCertificateType
 >;
 
 /**
- * Geographic coordinates. Derived from UPRN match or postcode centroid.
+ * Where the building is. Taken from the matched location where there is one, otherwise the centre of the postcode.
  */
 export type EPCQueryResponseCoordinates = {
   /**
-   * WGS84 latitude.
+   * Latitude in WGS84 decimal degrees.
    */
   latitude: number;
   /**
-   * WGS84 longitude.
+   * Longitude in WGS84 decimal degrees.
    */
   longitude: number;
 };
 
 /**
- * Built form: detached, semi_detached, mid_terrace, end_terrace, enclosed_mid_terrace, enclosed_end_terrace.
+ * How the dwelling sits in relation to its neighbours.
  */
 export const BuiltForm = {
   Detached: "detached",
@@ -193,34 +193,34 @@ export const BuiltForm = {
   EnclosedEndTerrace: "enclosed_end_terrace",
 } as const;
 /**
- * Built form: detached, semi_detached, mid_terrace, end_terrace, enclosed_mid_terrace, enclosed_end_terrace.
+ * How the dwelling sits in relation to its neighbours.
  */
 export type BuiltForm = OpenEnum<typeof BuiltForm>;
 
 /**
- * Structured construction age. Parsed from CONSTRUCTION_AGE_BAND text.
+ * The period the dwelling was built in, as a year range.
  */
 export type EPCQueryResponseConstructionAge = {
   /**
-   * End year of construction period. Null for 'XXXX onwards' bands.
+   * Last year of the construction period. Null when the band is open-ended, such as '2007 onwards'.
    */
   endYear: number | null;
   /**
-   * Whether the construction date is an exact year (true) or a range (false).
+   * True when the certificate gives an exact year of construction rather than a band.
    */
   isExact: boolean;
   /**
-   * Midpoint year. Useful for approximate age calculations.
+   * Midpoint of the construction period, for when a single year is needed.
    */
   midYear: number | null;
   /**
-   * Start year of construction period. Null for 'before XXXX' bands.
+   * First year of the construction period. Null when the band is open-ended, such as 'before 1900'.
    */
   startYear: number | null;
 };
 
 /**
- * Glazed area relative to typical property. Deprecated in RdSAP10 but persists in register from older assessments.
+ * How much glazing the dwelling has compared with a typical property of its type. Only older assessments carry it, as the current assessment procedure no longer records it.
  */
 export const EPCQueryResponseArea = {
   MuchLessThanTypical: "much_less_than_typical",
@@ -230,12 +230,12 @@ export const EPCQueryResponseArea = {
   MuchMoreThanTypical: "much_more_than_typical",
 } as const;
 /**
- * Glazed area relative to typical property. Deprecated in RdSAP10 but persists in register from older assessments.
+ * How much glazing the dwelling has compared with a typical property of its type. Only older assessments carry it, as the current assessment procedure no longer records it.
  */
 export type EPCQueryResponseArea = OpenEnum<typeof EPCQueryResponseArea>;
 
 /**
- * Glazing specification.
+ * What kind of glazing is fitted, with double glazing split by whether it was installed before 2002.
  */
 export const EPCQueryResponseType = {
   Single: "single",
@@ -248,30 +248,30 @@ export const EPCQueryResponseType = {
   NotDefined: "not_defined",
 } as const;
 /**
- * Glazing specification.
+ * What kind of glazing is fitted, with double glazing split by whether it was installed before 2002.
  */
 export type EPCQueryResponseType = OpenEnum<typeof EPCQueryResponseType>;
 
 /**
- * Glazing details.
+ * The dwelling's glazing.
  */
 export type Glazing = {
   /**
-   * Glazed area relative to typical property. Deprecated in RdSAP10 but persists in register from older assessments.
+   * How much glazing the dwelling has compared with a typical property of its type. Only older assessments carry it, as the current assessment procedure no longer records it.
    */
   area: EPCQueryResponseArea | null;
   /**
-   * Percentage of windows that are double/triple glazed.
+   * Percentage of the windows that are double or triple glazed, from 0 to 100.
    */
   proportion: number | null;
   /**
-   * Glazing specification.
+   * What kind of glazing is fitted, with double glazing split by whether it was installed before 2002.
    */
   type: EPCQueryResponseType | null;
 };
 
 /**
- * Tenure type: owner_occupied, rented_social, rented_private, unknown.
+ * Whether the dwelling is owner occupied or rented, and if rented, socially or privately.
  */
 export const EPCQueryResponseTenure = {
   OwnerOccupied: "owner_occupied",
@@ -280,174 +280,174 @@ export const EPCQueryResponseTenure = {
   Unknown: "unknown",
 } as const;
 /**
- * Tenure type: owner_occupied, rented_social, rented_private, unknown.
+ * Whether the dwelling is owner occupied or rented, and if rented, socially or privately.
  */
 export type EPCQueryResponseTenure = OpenEnum<typeof EPCQueryResponseTenure>;
 
 /**
- * Domestic property details — construction, rooms, glazing, Scotland-specific fields. Null for non-domestic and DECs.
+ * Details that apply to dwellings only: construction, rooms, glazing and the Scotland-specific measures. Null on non-domestic certificates and Display Energy Certificates.
  */
 export type DomesticDetails = {
   /**
-   * Built form: detached, semi_detached, mid_terrace, end_terrace, enclosed_mid_terrace, enclosed_end_terrace.
+   * How the dwelling sits in relation to its neighbours.
    */
   builtForm: BuiltForm | null;
   /**
-   * Structured construction age. Parsed from CONSTRUCTION_AGE_BAND text.
+   * The period the dwelling was built in, as a year range.
    */
   constructionAge: EPCQueryResponseConstructionAge | null;
   /**
-   * Raw construction age band text from source. E.g. 'England and Wales: 1930-1949' or 'before 1919'.
+   * The construction age band exactly as the certificate words it, for example 'England and Wales: 1930-1949' or 'before 1919'.
    */
   constructionAgeBandExternal: string | null;
   /**
-   * Number of extensions.
+   * Number of extensions the dwelling has.
    */
   extensionCount: number | null;
   /**
-   * Total number of storeys in the flat's building.
+   * Number of storeys in the building the flat is in.
    */
   flatStoreyCount: number | null;
   /**
-   * Whether the flat occupies the top storey. Derived from FLAT_TOP_STOREY (Y→true, N→false).
+   * True when the flat is on the top storey of its building.
    */
   flatTopStorey: boolean | null;
   /**
-   * Average floor-to-ceiling height in metres.
+   * Average floor-to-ceiling height, in metres.
    */
   floorHeight: number | null;
   /**
-   * Floor level (for flats).
+   * Which floor the dwelling is on, as recorded on the certificate. Recorded for flats.
    */
   floorLevel: string | null;
   /**
-   * Glazing details.
+   * The dwelling's glazing.
    */
   glazing: Glazing;
   /**
-   * Count of habitable rooms.
+   * Number of habitable rooms.
    */
   habitableRooms: number | null;
   /**
-   * Count of heated rooms.
+   * Number of heated rooms.
    */
   heatedRooms: number | null;
   /**
-   * Estimated SAP score impact of cavity wall insulation. Scotland only.
+   * Estimated change in SAP score from installing cavity wall insulation. Scotland only.
    */
   impactCavityWallInsulation: number | null;
   /**
-   * Estimated SAP score impact of loft insulation. Scotland only.
+   * Estimated change in SAP score from installing loft insulation. Scotland only.
    */
   impactLoftInsulation: number | null;
   /**
-   * Estimated SAP score impact of solid wall insulation. Scotland only.
+   * Estimated change in SAP score from installing solid wall insulation. Scotland only.
    */
   impactSolidWallInsulation: number | null;
   /**
-   * Percentage of light fittings that are low-energy.
+   * Percentage of the light fittings that are low energy, from 0 to 100.
    */
   lowEnergyLighting: number | null;
   /**
-   * Low/zero carbon energy sources description. Scotland only.
+   * The low and zero carbon energy sources present, as described on the certificate. Scotland only.
    */
   lzcEnergySources: string | null;
   /**
-   * Count of open fireplaces.
+   * Number of open fireplaces.
    */
   openFireplaces: number | null;
   /**
-   * Space heating demand in kWh/year. Scotland only.
+   * Annual space heating demand, in kWh per year. Scotland only.
    */
   spaceHeatingDemand: number | null;
   /**
-   * Tenure type: owner_occupied, rented_social, rented_private, unknown.
+   * Whether the dwelling is owner occupied or rented, and if rented, socially or privately.
    */
   tenure: EPCQueryResponseTenure | null;
   /**
-   * Three-year energy cost at current efficiency (£). Scotland only.
+   * Estimated energy cost over three years at the assessed efficiency, in GBP. Scotland only.
    */
   threeYearEnergyCostCurrent: number | null;
   /**
-   * Three-year potential energy saving (£). Scotland only.
+   * Estimated energy saving over three years if the recommended improvements are carried out, in GBP. Scotland only.
    */
   threeYearEnergySavingPotential: number | null;
   /**
-   * Water heating demand in kWh/year. Scotland only.
+   * Annual water heating demand, in kWh per year. Scotland only.
    */
   waterHeatingDemand: number | null;
 };
 
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export const EPCQueryResponseCo2Unit = {
   TonnesPerYear: "tonnes_per_year",
   KgCo2PerM2PerYear: "kg_co2_per_m2_per_year",
 } as const;
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export type EPCQueryResponseCo2Unit = OpenEnum<typeof EPCQueryResponseCo2Unit>;
 
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export const EPCQueryResponseEnergyConsumptionUnit = {
   KwhPerYear: "kwh_per_year",
   KwhPerM2PerYear: "kwh_per_m2_per_year",
 } as const;
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export type EPCQueryResponseEnergyConsumptionUnit = OpenEnum<
   typeof EPCQueryResponseEnergyConsumptionUnit
 >;
 
 /**
- * Environmental impact, CO2 emissions, and energy consumption.
+ * Carbon dioxide emissions, environmental impact scores and energy consumption.
  */
 export type EPCQueryResponseEmissions = {
   /**
-   * Current annual CO2 emissions. Domestic: tonnes/year. Non-domestic: kg CO2/m²/year (building emission rate). Check co2Unit for the measurement unit.
+   * Annual carbon dioxide emissions at the assessed efficiency. Domestic certificates report tonnes per year and non-domestic certificates report kg CO2 per m² per year; read `co2Unit` for the unit that applies to this record.
    */
   co2Current: number | null;
   /**
-   * CO2 intensity per unit floor area (kg CO2/m²/year). Directly reported for domestic (CO2_EMISS_CURR_PER_FLOOR_AREA). For non-domestic, this equals BUILDING_EMISSIONS.
+   * Annual carbon dioxide emissions per square metre of floor area, in kg CO2 per m² per year. On non-domestic certificates this is the building emission rate.
    */
   co2PerFloorArea: number | null;
   /**
-   * Achievable CO2 emissions after improvements. Domestic only; null for non-domestic and DECs.
+   * Annual carbon dioxide emissions once the recommended improvements are carried out. Domestic only; null on non-domestic certificates and Display Energy Certificates.
    */
   co2Potential: number | null;
   /**
-   * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+   * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
    */
   co2Unit: EPCQueryResponseCo2Unit;
   /**
-   * Current annual energy consumption. Domestic: kWh/year. Non-domestic: kWh/m²/year (PRIMARY_ENERGY_VALUE). Check energyConsumptionUnit for measurement unit.
+   * Annual energy consumption at the assessed efficiency. Domestic certificates report kWh per year and non-domestic certificates report kWh per m² per year; read `energyConsumptionUnit` for the unit that applies to this record.
    */
   energyConsumptionCurrent: number | null;
   /**
-   * Achievable energy consumption. Domestic only.
+   * Annual energy consumption once the recommended improvements are carried out. Domestic only.
    */
   energyConsumptionPotential: number | null;
   /**
-   * Unit of energyConsumptionCurrent measurement.
+   * The unit `energyConsumptionCurrent` is expressed in.
    */
   energyConsumptionUnit: EPCQueryResponseEnergyConsumptionUnit | null;
   /**
-   * Environmental impact score (1-100, higher is better). Domestic only.
+   * Environmental impact score from 1 to 100, where higher is better. Domestic only.
    */
   environmentalScoreCurrent: number | null;
   /**
-   * Achievable environmental impact score. Domestic only.
+   * The environmental impact score the property would reach once the recommended improvements are carried out, on the same 1 to 100 scale. Domestic only.
    */
   environmentalScorePotential: number | null;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseEnergyEfficiency = {
   VeryGood: "very_good",
@@ -457,14 +457,14 @@ export const EPCQueryResponseEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -474,32 +474,32 @@ export const EPCQueryResponseEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseEnvironmentalEfficiency = OpenEnum<
   typeof EPCQueryResponseEnvironmentalEfficiency
 >;
 
 /**
- * Air tightness assessment. Scotland only; null for E&W.
+ * The air tightness assessment. Scotland only; null on England and Wales certificates.
  */
 export type EPCQueryResponseAirTightness = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency: EPCQueryResponseEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency: EPCQueryResponseEnvironmentalEfficiency | null;
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCQueryResponseDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -509,14 +509,14 @@ export const EPCQueryResponseDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCQueryResponseDataQuality = OpenEnum<
   typeof EPCQueryResponseDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasEnergyEfficiency = {
   VeryGood: "very_good",
@@ -526,14 +526,14 @@ export const EPCQueryResponseSchemasEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -543,14 +543,14 @@ export const EPCQueryResponseSchemasEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasEnvironmentalEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasEnvironmentalEfficiency
 >;
 
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export const EPCQueryResponseFloorType = {
   Solid: "solid",
@@ -560,14 +560,14 @@ export const EPCQueryResponseFloorType = {
   OtherPremisesBelow: "other_premises_below",
 } as const;
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export type EPCQueryResponseFloorType = OpenEnum<
   typeof EPCQueryResponseFloorType
 >;
 
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export const EPCQueryResponseInsulationType = {
   None: "none",
@@ -583,58 +583,58 @@ export const EPCQueryResponseInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export type EPCQueryResponseInsulationType = OpenEnum<
   typeof EPCQueryResponseInsulationType
 >;
 
 /**
- * Ground floor construction and insulation.
+ * The ground floor and its insulation.
  */
 export type EPCQueryResponseFloor = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality: EPCQueryResponseDataQuality | null;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the floor, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the floor is, on the certificate's five-point scale.
    */
   energyEfficiency: EPCQueryResponseSchemasEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How the floor scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasEnvironmentalEfficiency
     | null;
   /**
-   * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+   * How the ground floor is built, including the cases where another dwelling or premises sits below.
    */
   floorType: EPCQueryResponseFloorType | null;
   /**
-   * Whether insulation status is assumed.
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed: boolean;
   /**
-   * Whether floor insulation is present.
+   * True when the floor is insulated.
    */
   insulationPresent: boolean | null;
   /**
-   * Insulation type if present.
+   * How the floor is insulated, where insulation is present.
    */
   insulationType: EPCQueryResponseInsulationType | null;
   /**
-   * U-value in W/m²K if reported.
+   * Thermal transmittance (U-value) of the floor, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance: number | null;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataEnergyEfficiency = {
   VeryGood: "very_good",
@@ -644,14 +644,14 @@ export const EPCQueryResponseSchemasDataEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -661,26 +661,26 @@ export const EPCQueryResponseSchemasDataEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataEnvironmentalEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataEnvironmentalEfficiency
 >;
 
 /**
- * Heating control system.
+ * How the heating is controlled.
  */
 export type EPCQueryResponseHeatingControls = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency: EPCQueryResponseSchemasDataEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataEnvironmentalEfficiency
@@ -688,7 +688,7 @@ export type EPCQueryResponseHeatingControls = {
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricEnergyEfficiency = {
   VeryGood: "very_good",
@@ -698,14 +698,14 @@ export const EPCQueryResponseSchemasDataFabricEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -715,26 +715,26 @@ export const EPCQueryResponseSchemasDataFabricEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricEnvironmentalEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricEnvironmentalEfficiency
 >;
 
 /**
- * Hot water system.
+ * The hot water system.
  */
 export type EPCQueryResponseHotWater = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency: EPCQueryResponseSchemasDataFabricEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricEnvironmentalEfficiency
@@ -742,7 +742,7 @@ export type EPCQueryResponseHotWater = {
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricLightingEnergyEfficiency = {
   VeryGood: "very_good",
@@ -752,13 +752,13 @@ export const EPCQueryResponseSchemasDataFabricLightingEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricLightingEnergyEfficiency =
   OpenEnum<typeof EPCQueryResponseSchemasDataFabricLightingEnergyEfficiency>;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricLightingEnvironmentalEfficiency =
   {
@@ -769,7 +769,7 @@ export const EPCQueryResponseSchemasDataFabricLightingEnvironmentalEfficiency =
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricLightingEnvironmentalEfficiency =
   OpenEnum<
@@ -777,21 +777,21 @@ export type EPCQueryResponseSchemasDataFabricLightingEnvironmentalEfficiency =
   >;
 
 /**
- * Lighting system.
+ * The lighting installed.
  */
 export type EPCQueryResponseLighting = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricLightingEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricLightingEnvironmentalEfficiency
@@ -799,7 +799,7 @@ export type EPCQueryResponseLighting = {
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCQueryResponseSchemasDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -809,14 +809,14 @@ export const EPCQueryResponseSchemasDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCQueryResponseSchemasDataQuality = OpenEnum<
   typeof EPCQueryResponseSchemasDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricMainHeatingEnergyEfficiency = {
   VeryGood: "very_good",
@@ -826,13 +826,13 @@ export const EPCQueryResponseSchemasDataFabricMainHeatingEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricMainHeatingEnergyEfficiency =
   OpenEnum<typeof EPCQueryResponseSchemasDataFabricMainHeatingEnergyEfficiency>;
 
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricMainHeatingEnvironmentalEfficiency =
   {
@@ -843,7 +843,7 @@ export const EPCQueryResponseSchemasDataFabricMainHeatingEnvironmentalEfficiency
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricMainHeatingEnvironmentalEfficiency =
   OpenEnum<
@@ -851,7 +851,7 @@ export type EPCQueryResponseSchemasDataFabricMainHeatingEnvironmentalEfficiency
   >;
 
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export const EPCQueryResponseFuel = {
   MainsGas: "mains_gas",
@@ -870,12 +870,12 @@ export const EPCQueryResponseFuel = {
   Other: "other",
 } as const;
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export type EPCQueryResponseFuel = OpenEnum<typeof EPCQueryResponseFuel>;
 
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export const EPCQueryResponseHeatPumpType = {
   AirSource: "air_source",
@@ -883,14 +883,14 @@ export const EPCQueryResponseHeatPumpType = {
   WaterSource: "water_source",
 } as const;
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export type EPCQueryResponseHeatPumpType = OpenEnum<
   typeof EPCQueryResponseHeatPumpType
 >;
 
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export const EPCQueryResponseSystemType = {
   BoilerRadiators: "boiler_radiators",
@@ -906,56 +906,56 @@ export const EPCQueryResponseSystemType = {
   NoneAssumed: "none_assumed",
 } as const;
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export type EPCQueryResponseSystemType = OpenEnum<
   typeof EPCQueryResponseSystemType
 >;
 
 /**
- * Main heating system.
+ * The main heating system.
  */
 export type EPCQueryResponseMainHeating = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality: EPCQueryResponseSchemasDataQuality | null;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the heating system, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the heating system is, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricMainHeatingEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the heating system scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricMainHeatingEnvironmentalEfficiency
     | null;
   /**
-   * Fuel type for this heating system.
+   * The fuel this heating system runs on.
    */
   fuel: EPCQueryResponseFuel | null;
   /**
-   * Heat pump type if applicable: air_source, ground_source, water_source.
+   * Where the heat pump draws its heat from, where the system is a heat pump.
    */
   heatPumpType: EPCQueryResponseHeatPumpType | null;
   /**
-   * Whether this property has multiple heating systems.
+   * True when the certificate records more than one heating system.
    */
   isMultiSystem: boolean;
   /**
-   * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+   * What kind of main heating system is installed.
    */
   systemType: EPCQueryResponseSystemType | null;
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCQueryResponseSchemasDataDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -965,14 +965,14 @@ export const EPCQueryResponseSchemasDataDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCQueryResponseSchemasDataDataQuality = OpenEnum<
   typeof EPCQueryResponseSchemasDataDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricRoofEnergyEfficiency = {
   VeryGood: "very_good",
@@ -982,14 +982,14 @@ export const EPCQueryResponseSchemasDataFabricRoofEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricRoofEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricRoofEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricRoofEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -999,13 +999,13 @@ export const EPCQueryResponseSchemasDataFabricRoofEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricRoofEnvironmentalEfficiency =
   OpenEnum<typeof EPCQueryResponseSchemasDataFabricRoofEnvironmentalEfficiency>;
 
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export const EPCQueryResponseSchemasInsulationType = {
   None: "none",
@@ -1021,14 +1021,14 @@ export const EPCQueryResponseSchemasInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export type EPCQueryResponseSchemasInsulationType = OpenEnum<
   typeof EPCQueryResponseSchemasInsulationType
 >;
 
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export const EPCQueryResponseRoofType = {
   Pitched: "pitched",
@@ -1039,64 +1039,64 @@ export const EPCQueryResponseRoofType = {
   RoofRoom: "roof_room",
 } as const;
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export type EPCQueryResponseRoofType = OpenEnum<
   typeof EPCQueryResponseRoofType
 >;
 
 /**
- * Roof construction and insulation.
+ * The roof and its insulation.
  */
 export type EPCQueryResponseRoof = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality: EPCQueryResponseSchemasDataDataQuality | null;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the roof, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the roof is, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricRoofEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the roof scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricRoofEnvironmentalEfficiency
     | null;
   /**
-   * Whether insulation status is assumed.
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed: boolean;
   /**
-   * Loft insulation depth in millimetres.
+   * Depth of the loft insulation, in millimetres.
    */
   insulationDepthMm: number | null;
   /**
-   * Whether roof insulation is present.
+   * True when the roof is insulated.
    */
   insulationPresent: boolean | null;
   /**
-   * Insulation type: loft, rafter, none, etc.
+   * How the roof is insulated, if at all.
    */
   insulationType: EPCQueryResponseSchemasInsulationType | null;
   /**
-   * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+   * How the roof is built, including the cases where another dwelling or premises sits above.
    */
   roofType: EPCQueryResponseRoofType | null;
   /**
-   * U-value in W/m²K if reported.
+   * Thermal transmittance (U-value) of the roof, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance: number | null;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricSecondaryHeatingEnergyEfficiency =
   {
@@ -1107,7 +1107,7 @@ export const EPCQueryResponseSchemasDataFabricSecondaryHeatingEnergyEfficiency =
     VeryPoor: "very_poor",
   } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricSecondaryHeatingEnergyEfficiency =
   OpenEnum<
@@ -1115,7 +1115,7 @@ export type EPCQueryResponseSchemasDataFabricSecondaryHeatingEnergyEfficiency =
   >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricSecondaryHeatingEnvironmentalEfficiency =
   {
@@ -1126,7 +1126,7 @@ export const EPCQueryResponseSchemasDataFabricSecondaryHeatingEnvironmentalEffic
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricSecondaryHeatingEnvironmentalEfficiency =
   OpenEnum<
@@ -1134,21 +1134,21 @@ export type EPCQueryResponseSchemasDataFabricSecondaryHeatingEnvironmentalEffici
   >;
 
 /**
- * Secondary heating system. Null when no secondary heating is present.
+ * Any secondary heating system. Null when the property has none.
  */
 export type EPCQueryResponseSecondaryHeating = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricSecondaryHeatingEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricSecondaryHeatingEnvironmentalEfficiency
@@ -1156,7 +1156,7 @@ export type EPCQueryResponseSecondaryHeating = {
 };
 
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export const EPCQueryResponseConstruction = {
   Cavity: "cavity",
@@ -1174,14 +1174,14 @@ export const EPCQueryResponseConstruction = {
   CurtainWall: "curtain_wall",
 } as const;
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export type EPCQueryResponseConstruction = OpenEnum<
   typeof EPCQueryResponseConstruction
 >;
 
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCQueryResponseSchemasDataFabricDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -1191,14 +1191,14 @@ export const EPCQueryResponseSchemasDataFabricDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCQueryResponseSchemasDataFabricDataQuality = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricWallsEnergyEfficiency = {
   VeryGood: "very_good",
@@ -1208,14 +1208,14 @@ export const EPCQueryResponseSchemasDataFabricWallsEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricWallsEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricWallsEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricWallsEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -1225,7 +1225,7 @@ export const EPCQueryResponseSchemasDataFabricWallsEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricWallsEnvironmentalEfficiency =
   OpenEnum<
@@ -1233,7 +1233,7 @@ export type EPCQueryResponseSchemasDataFabricWallsEnvironmentalEfficiency =
   >;
 
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export const EPCQueryResponseSchemasDataInsulationType = {
   None: "none",
@@ -1249,64 +1249,64 @@ export const EPCQueryResponseSchemasDataInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export type EPCQueryResponseSchemasDataInsulationType = OpenEnum<
   typeof EPCQueryResponseSchemasDataInsulationType
 >;
 
 /**
- * External wall construction and insulation.
+ * The external walls and their insulation.
  */
 export type EPCQueryResponseWalls = {
   /**
-   * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+   * How the external walls are built.
    */
   construction: EPCQueryResponseConstruction | null;
   /**
-   * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality: EPCQueryResponseSchemasDataFabricDataQuality | null;
   /**
-   * Raw SAP description string from assessor.
+   * The assessor's own description of the walls, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the walls are, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricWallsEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the walls score for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricWallsEnvironmentalEfficiency
     | null;
   /**
-   * Whether insulation status is assumed by the assessor (true) or confirmed (false).
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed: boolean;
   /**
-   * Whether wall insulation is present.
+   * True when the walls are insulated.
    */
   insulationPresent: boolean | null;
   /**
-   * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+   * How the walls are insulated, if at all.
    */
   insulationType: EPCQueryResponseSchemasDataInsulationType | null;
   /**
-   * Wall material (e.g. 'brick') where identifiable from description.
+   * The wall material, for example 'brick', where the assessor's description identifies one.
    */
   material: string | null;
   /**
-   * U-value in W/m²K if reported. Newer SAP versions report this instead of description text.
+   * Thermal transmittance (U-value) of the walls, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance: number | null;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricWindowsEnergyEfficiency = {
   VeryGood: "very_good",
@@ -1316,14 +1316,14 @@ export const EPCQueryResponseSchemasDataFabricWindowsEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricWindowsEnergyEfficiency = OpenEnum<
   typeof EPCQueryResponseSchemasDataFabricWindowsEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCQueryResponseSchemasDataFabricWindowsEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -1333,7 +1333,7 @@ export const EPCQueryResponseSchemasDataFabricWindowsEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCQueryResponseSchemasDataFabricWindowsEnvironmentalEfficiency =
   OpenEnum<
@@ -1341,21 +1341,21 @@ export type EPCQueryResponseSchemasDataFabricWindowsEnvironmentalEfficiency =
   >;
 
 /**
- * Window glazing specification.
+ * The windows and their glazing.
  */
 export type EPCQueryResponseWindows = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description: string | null;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency:
     | EPCQueryResponseSchemasDataFabricWindowsEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | EPCQueryResponseSchemasDataFabricWindowsEnvironmentalEfficiency
@@ -1363,63 +1363,64 @@ export type EPCQueryResponseWindows = {
 };
 
 /**
- * Component-level building fabric assessment. Domestic only; null for non-domestic and DECs.
+ * Component-by-component assessment of the building fabric. Domestic only; null on non-domestic certificates and Display Energy Certificates.
  */
 export type EPCQueryResponseFabric = {
   /**
-   * Air tightness assessment. Scotland only; null for E&W.
+   * The air tightness assessment. Scotland only; null on England and Wales certificates.
    */
   airTightness: EPCQueryResponseAirTightness | null;
   /**
-   * Ground floor construction and insulation.
+   * The ground floor and its insulation.
    */
   floor: EPCQueryResponseFloor;
   /**
-   * Heating control system.
+   * How the heating is controlled.
    */
   heatingControls: EPCQueryResponseHeatingControls;
   /**
-   * Hot water system.
+   * The hot water system.
    */
   hotWater: EPCQueryResponseHotWater;
   /**
-   * Lighting system.
+   * The lighting installed.
    */
   lighting: EPCQueryResponseLighting;
   /**
-   * Main heating system.
+   * The main heating system.
    */
   mainHeating: EPCQueryResponseMainHeating;
   /**
-   * Roof construction and insulation.
+   * The roof and its insulation.
    */
   roof: EPCQueryResponseRoof;
   /**
-   * Secondary heating system. Null when no secondary heating is present.
+   * Any secondary heating system. Null when the property has none.
    */
   secondaryHeating: EPCQueryResponseSecondaryHeating | null;
   /**
-   * External wall construction and insulation.
+   * The external walls and their insulation.
    */
   walls: EPCQueryResponseWalls;
   /**
-   * Window glazing specification.
+   * The windows and their glazing.
    */
   windows: EPCQueryResponseWindows;
 };
 
 /**
- * Derived MEES compliance status (Decision D11). Based on current energy rating band and certificate type. compliant=A-E, at_risk=E, non_compliant=F-G, exempt=non-domestic/DEC.
+ * Whether the building meets the Minimum Energy Efficiency Standard, worked out from the current rating band, the certificate type and the nation. `compliant` covers bands A to D, `non_compliant` bands F and G, and `at_risk` marks band E as lettable today with no headroom under the expected tightening to C. The standard is SI 2015/962, which covers both domestic and non-domestic private rented property in England and Wales but does not extend to Scotland, and which is assessed on an asset rating rather than the operational rating a Display Energy Certificate carries — so Scottish certificates and DECs are `not_applicable`. `exempt` means a registered PRS exemption and appears only on legacy rows; it is never derived from certificate data. `unknown` means there is not enough data to decide.
  */
 export const EPCQueryResponseMeesCompliance = {
   Compliant: "compliant",
   AtRisk: "at_risk",
   NonCompliant: "non_compliant",
+  NotApplicable: "not_applicable",
   Exempt: "exempt",
   Unknown: "unknown",
 } as const;
 /**
- * Derived MEES compliance status (Decision D11). Based on current energy rating band and certificate type. compliant=A-E, at_risk=E, non_compliant=F-G, exempt=non-domestic/DEC.
+ * Whether the building meets the Minimum Energy Efficiency Standard, worked out from the current rating band, the certificate type and the nation. `compliant` covers bands A to D, `non_compliant` bands F and G, and `at_risk` marks band E as lettable today with no headroom under the expected tightening to C. The standard is SI 2015/962, which covers both domestic and non-domestic private rented property in England and Wales but does not extend to Scotland, and which is assessed on an asset rating rather than the operational rating a Display Energy Certificate carries — so Scottish certificates and DECs are `not_applicable`. `exempt` means a registered PRS exemption and appears only on legacy rows; it is never derived from certificate data. `unknown` means there is not enough data to decide.
  */
 export type EPCQueryResponseMeesCompliance = OpenEnum<
   typeof EPCQueryResponseMeesCompliance
@@ -1459,21 +1460,21 @@ export const BuildingCategory = {
 export type BuildingCategory = OpenEnum<typeof BuildingCategory>;
 
 /**
- * Electrical usage — actual vs benchmark.
+ * Electricity use measured against its benchmark.
  */
 export type ElectricalUsage = {
   /**
-   * Actual annual electrical consumption (kWh/m²/year).
+   * Measured annual electricity use, in kWh per m² per year.
    */
   actual: number;
   /**
-   * Benchmark electrical consumption (kWh/m²/year).
+   * Benchmark electricity use for a building of this type, in kWh per m² per year.
    */
   typical: number;
 };
 
 /**
- * Operational rating band (A-G, no A+).
+ * Band for the operational rating. Display Energy Certificates run A to G, with no A+.
  */
 export const RatingBand = {
   APlus: "A+",
@@ -1491,84 +1492,84 @@ export const RatingBand = {
   G: "G",
 } as const;
 /**
- * Operational rating band (A-G, no A+).
+ * Band for the operational rating. Display Energy Certificates run A to G, with no A+.
  */
 export type RatingBand = OpenEnum<typeof RatingBand>;
 
 /**
- * Thermal fuel usage — actual vs benchmark.
+ * Thermal fuel use measured against its benchmark.
  */
 export type ThermalUsage = {
   /**
-   * Actual annual thermal fuel consumption (kWh/m²/year).
+   * Measured annual thermal fuel use, in kWh per m² per year.
    */
   actual: number;
   /**
-   * Benchmark thermal fuel consumption (kWh/m²/year).
+   * Benchmark thermal fuel use for a building of this type, in kWh per m² per year.
    */
   typical: number;
 };
 
 /**
- * DEC operational performance from metered energy use. Null for domestic and non-domestic EPCs.
+ * Operational performance taken from the building's metered energy use. Null on domestic and non-domestic certificates.
  */
 export type OperationalPerformance = {
   /**
-   * End of the 12-month assessment period (ISO 8601).
+   * The last day of the 12-month period the assessment covers, as an ISO 8601 date.
    */
   assessmentEndDate: string | null;
   /**
-   * CIBSE TM46 benchmark category codes. Multi-use buildings can have multiple codes.
+   * The CIBSE TM46 benchmark categories the building is measured against. A mixed-use building carries more than one.
    */
   buildingCategory: Array<BuildingCategory>;
   /**
-   * Current year operational rating — CO2 efficiency relative to benchmark. 100 = typical for building type. Lower is better. 9999 = placeholder/incomplete.
+   * Operational rating for the current year, comparing the building's carbon dioxide emissions with the benchmark for its type. 100 is typical for the type and lower is better. A value of 9999 means the assessment is incomplete.
    */
   currentRating: number;
   /**
-   * Electrical usage — actual vs benchmark.
+   * Electricity use measured against its benchmark.
    */
   electricalUsage: ElectricalUsage | null;
   /**
-   * Primary benchmark category description (e.g. 'General Office', 'Hospital — Clinical and Research').
+   * The main benchmark category in words, for example 'General Office'.
    */
   mainBenchmark: string | null;
   /**
-   * Assessor-selected reference date (ISO 8601).
+   * The reference date the assessor chose for this assessment, as an ISO 8601 date.
    */
   nominatedDate: string | null;
   /**
-   * Building occupancy during operating hours.
+   * How heavily the building is occupied during its operating hours.
    */
   occupancyLevel: string | null;
   /**
-   * Operational rating band (A-G, no A+).
+   * Band for the operational rating. Display Energy Certificates run A to G, with no A+.
    */
   ratingBand: RatingBand;
   /**
-   * Percentage of electricity from renewable sources.
+   * Percentage of the building's electricity supplied from renewable sources.
    */
   renewablesElectricalPercentage: number | null;
   /**
-   * Percentage of heating from renewable sources.
+   * Percentage of the building's heat supplied from renewable sources.
    */
   renewablesThermalPercentage: number | null;
   /**
-   * Thermal fuel usage — actual vs benchmark.
+   * Thermal fuel use measured against its benchmark.
    */
   thermalUsage: ThermalUsage | null;
   /**
-   * Previous year operational rating.
+   * Operational rating for the previous year.
    */
   yr1Rating: number | null;
   /**
-   * Two years ago operational rating.
+   * Operational rating for the year before that.
    */
   yr2Rating: number | null;
 };
 
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export const EPCQueryResponseBand = {
   APlus: "A+",
@@ -1586,12 +1587,12 @@ export const EPCQueryResponseBand = {
   G: "G",
 } as const;
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCQueryResponseBand = OpenEnum<typeof EPCQueryResponseBand>;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const EPCQueryResponseScoreType = {
   Sap: "sap",
@@ -1600,32 +1601,32 @@ export const EPCQueryResponseScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type EPCQueryResponseScoreType = OpenEnum<
   typeof EPCQueryResponseScoreType
 >;
 
 /**
- * Current energy rating at time of assessment.
+ * The rating the building holds as assessed.
  */
 export type EPCQueryResponseCurrent = {
   /**
-   * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+   * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
    */
   band: EPCQueryResponseBand;
   /**
-   * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+   * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
    */
   score: number;
   /**
-   * Discriminator for numeric score interpretation.
+   * Which scale `score` is on. Read it before comparing scores across certificates.
    */
   scoreType: EPCQueryResponseScoreType;
 };
 
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export const EPCQueryResponseSchemasBand = {
   APlus: "A+",
@@ -1643,14 +1644,14 @@ export const EPCQueryResponseSchemasBand = {
   G: "G",
 } as const;
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCQueryResponseSchemasBand = OpenEnum<
   typeof EPCQueryResponseSchemasBand
 >;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const EPCQueryResponseSchemasScoreType = {
   Sap: "sap",
@@ -1659,50 +1660,50 @@ export const EPCQueryResponseSchemasScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type EPCQueryResponseSchemasScoreType = OpenEnum<
   typeof EPCQueryResponseSchemasScoreType
 >;
 
 /**
- * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+ * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
  */
 export type EPCQueryResponsePotential = {
   /**
-   * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+   * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
    */
   band: EPCQueryResponseSchemasBand;
   /**
-   * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+   * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
    */
   score: number;
   /**
-   * Discriminator for numeric score interpretation.
+   * Which scale `score` is on. Read it before comparing scores across certificates.
    */
   scoreType: EPCQueryResponseSchemasScoreType;
 };
 
 /**
- * Energy rating — unified across domestic (SAP), non-domestic (asset), and DEC (operational). Filter on rating.current.band for cross-type comparisons.
+ * The building's energy rating. Every certificate type carries one, so filter on `rating.current.band` to compare efficiency across types.
  */
 export type EPCQueryResponseRating = {
   /**
-   * Whether the building achieves net-zero carbon. Scotland non-domestic uses 'Carbon Neu' band; mapped to A+ with this flag set to true.
+   * True when the building is rated carbon neutral. Scotland non-domestic certificates record this as a 'Carbon Neu' band, which is published here as band `A+` with this flag set.
    */
   carbonNeutral: boolean;
   /**
-   * Current energy rating at time of assessment.
+   * The rating the building holds as assessed.
    */
   current: EPCQueryResponseCurrent;
   /**
-   * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+   * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
    */
   potential: EPCQueryResponsePotential | null;
 };
 
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export const EPCQueryResponseCategory = {
   Insulation: "insulation",
@@ -1713,14 +1714,14 @@ export const EPCQueryResponseCategory = {
   Lighting: "lighting",
 } as const;
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export type EPCQueryResponseCategory = OpenEnum<
   typeof EPCQueryResponseCategory
 >;
 
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export const EPCQueryResponseCo2Impact = {
   Low: "low",
@@ -1728,53 +1729,53 @@ export const EPCQueryResponseCo2Impact = {
   High: "high",
 } as const;
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export type EPCQueryResponseCo2Impact = OpenEnum<
   typeof EPCQueryResponseCo2Impact
 >;
 
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export const EPCQueryResponseCurrency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export type EPCQueryResponseCurrency = ClosedEnum<
   typeof EPCQueryResponseCurrency
 >;
 
 /**
- * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+ * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
  */
 export type EPCQueryResponseCost = {
   /**
-   * Currency. All values normalised to GBP.
+   * The currency of the cost figures. Always `GBP`.
    */
   currency: EPCQueryResponseCurrency;
   /**
-   * Raw cost string from source (e.g. '£100 - £350'). Preserved for transparency.
+   * The cost range exactly as the certificate words it, for example '£100 - £350'.
    */
   indicative: string | null;
   /**
-   * Upper bound cost estimate (£ GBP).
+   * High end of the estimated cost, in GBP.
    */
   max: number | null;
   /**
-   * Lower bound cost estimate (£ GBP).
+   * Low end of the estimated cost, in GBP.
    */
   min: number | null;
   /**
-   * Assessment year for this cost estimate. Consumers should apply their own inflation adjustment from this base year.
+   * The year the cost was estimated in. Treat it as the base year when adjusting for inflation.
    */
   year: number | null;
 };
 
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export const EPCQueryResponseMeasure = {
   WallInsulation: "wall_insulation",
@@ -1819,12 +1820,12 @@ export const EPCQueryResponseMeasure = {
   LowEnergyLighting: "low_energy_lighting",
 } as const;
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export type EPCQueryResponseMeasure = OpenEnum<typeof EPCQueryResponseMeasure>;
 
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export const EPCQueryResponsePaybackType = {
   Short: "short",
@@ -1833,173 +1834,173 @@ export const EPCQueryResponsePaybackType = {
   Other: "other",
 } as const;
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export type EPCQueryResponsePaybackType = OpenEnum<
   typeof EPCQueryResponsePaybackType
 >;
 
 /**
- * Projected rating after this measure. Domestic only.
+ * The rating reached once this measure is carried out. Domestic only.
  */
 export type EPCQueryResponseProjectedRating = {
   /**
-   * Projected energy band after this measure (e.g. 'C').
+   * The energy band the dwelling reaches once this measure is in place, for example 'C'.
    */
   band: string | null;
   /**
-   * Projected cumulative SAP score after implementing this and all prior measures.
+   * The SAP score the dwelling reaches with this measure and every measure before it in the sequence.
    */
   energyScore: number | null;
   /**
-   * Projected cumulative environmental score.
+   * The environmental impact score the dwelling reaches with this measure and every measure before it.
    */
   environmentalScore: number | null;
 };
 
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export const EPCQueryResponseSchemasCurrency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export type EPCQueryResponseSchemasCurrency = ClosedEnum<
   typeof EPCQueryResponseSchemasCurrency
 >;
 
 /**
- * Estimated annual saving in GBP. Parsed from source typical saving field.
+ * What the measure is estimated to save each year, in GBP.
  */
 export type EPCQueryResponseSaving = {
   /**
-   * Estimated annual saving (£ GBP).
+   * Estimated saving each year, in GBP.
    */
   annual: number | null;
   /**
-   * Currency.
+   * The currency of the saving. Always `GBP`.
    */
   currency: EPCQueryResponseSchemasCurrency;
 };
 
 /**
- * Individual improvement recommendation with structured cost/saving values, canonical measure classification, and projected rating impact.
+ * One recommended improvement, with its cost and saving estimates, its standard measure classification, and the rating it would achieve.
  */
 export type EPCQueryResponseRecommendations = {
   /**
-   * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+   * What kind of improvement the measure is.
    */
   category: EPCQueryResponseCategory | null;
   /**
-   * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+   * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
    */
   co2Impact: EPCQueryResponseCo2Impact | null;
   /**
-   * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+   * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
    */
   cost: EPCQueryResponseCost | null;
   /**
-   * Detailed description with guidance text.
+   * The fuller explanation of the measure, as worded on the certificate.
    */
   description: string | null;
   /**
-   * Whether this measure is eligible for Green Deal financing. Boolean — not a raw string code.
+   * True when the measure qualifies for Green Deal financing.
    */
   greenDealEligible: boolean | null;
   /**
-   * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+   * Which improvement is recommended, mapped to a standard set of measures.
    */
   measure: EPCQueryResponseMeasure | null;
   /**
-   * Source measure code. E&W: IMPROVEMENT_ID. Scotland: EPC-prefixed (e.g. EPC-R4).
+   * The code this measure carries on the source certificate. Scottish certificates prefix theirs with 'EPC-', such as 'EPC-R4'.
    */
   measureCode: string | null;
   /**
-   * Payback period classification. Non-domestic only: short, medium, long, other.
+   * How long the measure takes to pay for itself. Non-domestic only.
    */
   paybackType: EPCQueryResponsePaybackType | null;
   /**
-   * Projected rating after this measure. Domestic only.
+   * The rating reached once this measure is carried out. Domestic only.
    */
   projectedRating: EPCQueryResponseProjectedRating | null;
   /**
-   * Estimated annual saving in GBP. Parsed from source typical saving field.
+   * What the measure is estimated to save each year, in GBP.
    */
   saving: EPCQueryResponseSaving | null;
   /**
-   * Priority order. Implementing measures in sequence provides the most cost-effective path.
+   * Position in the recommended order. Carrying the measures out in this order gives the most cost-effective path.
    */
   sequence: number;
   /**
-   * Short description of the improvement measure.
+   * The measure in a short line, as worded on the certificate.
    */
   summary: string | null;
 };
 
 /**
- * Annual heating costs — current and achievable.
+ * Estimated annual heating cost, as assessed and after improvement.
  */
 export type EPCQueryResponseHeating = {
   /**
-   * Current annual heating cost (£).
+   * Estimated annual heating cost at the assessed efficiency, in GBP.
    */
   current: number;
   /**
-   * Achievable annual heating cost (£).
+   * Estimated annual heating cost once the recommended improvements are carried out, in GBP.
    */
   potential: number;
 };
 
 /**
- * Annual hot water costs — current and achievable.
+ * Estimated annual hot water cost, as assessed and after improvement.
  */
 export type EPCQueryResponseSchemasHotWater = {
   /**
-   * Current annual hot water cost (£).
+   * Estimated annual hot water cost at the assessed efficiency, in GBP.
    */
   current: number;
   /**
-   * Achievable annual hot water cost (£).
+   * Estimated annual hot water cost once the recommended improvements are carried out, in GBP.
    */
   potential: number;
 };
 
 /**
- * Annual lighting costs — current and achievable.
+ * Estimated annual lighting cost, as assessed and after improvement.
  */
 export type EPCQueryResponseSchemasLighting = {
   /**
-   * Current annual lighting cost (£).
+   * Estimated annual lighting cost at the assessed efficiency, in GBP.
    */
   current: number;
   /**
-   * Achievable annual lighting cost (£).
+   * Estimated annual lighting cost once the recommended improvements are carried out, in GBP.
    */
   potential: number;
 };
 
 /**
- * Annual running costs in GBP. Domestic only; null for non-domestic and DECs.
+ * Estimated annual running costs in GBP. Domestic only; null on non-domestic certificates and Display Energy Certificates.
  */
 export type EPCQueryResponseRunningCosts = {
   /**
-   * Annual heating costs — current and achievable.
+   * Estimated annual heating cost, as assessed and after improvement.
    */
   heating: EPCQueryResponseHeating;
   /**
-   * Annual hot water costs — current and achievable.
+   * Estimated annual hot water cost, as assessed and after improvement.
    */
   hotWater: EPCQueryResponseSchemasHotWater;
   /**
-   * Annual lighting costs — current and achievable.
+   * Estimated annual lighting cost, as assessed and after improvement.
    */
   lighting: EPCQueryResponseSchemasLighting;
 };
 
 /**
- * Current band including Scotland half-bands (B+, C+, etc.) and 'Carbon Neu' → A+.
+ * Band for that rating. Scotland uses half-bands such as B+ and C+, and a carbon neutral building is published here as `A+`.
  */
 export const CurrentBand = {
   APlus: "A+",
@@ -2017,12 +2018,12 @@ export const CurrentBand = {
   G: "G",
 } as const;
 /**
- * Current band including Scotland half-bands (B+, C+, etc.) and 'Carbon Neu' → A+.
+ * Band for that rating. Scotland uses half-bands such as B+ and C+, and a carbon neutral building is published here as `A+`.
  */
 export type CurrentBand = OpenEnum<typeof CurrentBand>;
 
 /**
- * Potential band.
+ * Band for the achievable rating.
  */
 export const PotentialBand = {
   APlus: "A+",
@@ -2040,46 +2041,46 @@ export const PotentialBand = {
   G: "G",
 } as const;
 /**
- * Potential band.
+ * Band for the achievable rating.
  */
 export type PotentialBand = OpenEnum<typeof PotentialBand>;
 
 /**
- * Scotland's native non-domestic rating using Scottish weather data. Null for E&W certificates and domestic certificates.
+ * Scotland's own non-domestic rating, calculated with Scottish weather data. Null on domestic certificates and on England and Wales certificates.
  */
 export type ScotlandNativeRating = {
   /**
-   * Current band including Scotland half-bands (B+, C+, etc.) and 'Carbon Neu' → A+.
+   * Band for that rating. Scotland uses half-bands such as B+ and C+, and a carbon neutral building is published here as `A+`.
    */
   currentBand: CurrentBand;
   /**
-   * Current Energy Performance Rating using Scottish weather data (kg CO2/m²/year).
+   * The building's energy performance rating calculated with Scottish weather data, in kg CO2 per m² per year.
    */
   currentRating: number;
   /**
-   * Potential band.
+   * Band for the achievable rating.
    */
   potentialBand: PotentialBand | null;
   /**
-   * Potential rating if improvements carried out. Scotland publishes this; E&W does not.
+   * The rating the building would reach if the recommended improvements were carried out. Scotland publishes this; England and Wales does not.
    */
   potentialRating: number | null;
 };
 
 /**
- * Source register: mhclg (England & Wales) or scottish_government (Scotland).
+ * Which national register the certificate came from: `mhclg` for England and Wales, `scottish_government` for Scotland.
  */
 export const EPCQueryResponseSource = {
   Mhclg: "mhclg",
   ScottishGovernment: "scottish_government",
 } as const;
 /**
- * Source register: mhclg (England & Wales) or scottish_government (Scotland).
+ * Which national register the certificate came from: `mhclg` for England and Wales, `scottish_government` for Scotland.
  */
 export type EPCQueryResponseSource = OpenEnum<typeof EPCQueryResponseSource>;
 
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export const EPCQueryResponseInspectionStatus = {
   Completed: "completed",
@@ -2089,36 +2090,36 @@ export const EPCQueryResponseInspectionStatus = {
   Unknown: "unknown",
 } as const;
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export type EPCQueryResponseInspectionStatus = OpenEnum<
   typeof EPCQueryResponseInspectionStatus
 >;
 
 /**
- * Air conditioning details. Non-domestic/DEC only; null for domestic.
+ * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
  */
 export type EPCQueryResponseAirConditioning = {
   /**
-   * Estimated AC capacity when actual is unknown (kW).
+   * Estimated capacity of the air conditioning system, in kW, used when the rated capacity is unknown.
    */
   estimatedKwRating: number | null;
   /**
-   * AC inspection commissioning status.
+   * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
    */
   inspectionStatus: EPCQueryResponseInspectionStatus | null;
   /**
-   * Actual AC system capacity (kW).
+   * Rated capacity of the air conditioning system, in kW.
    */
   kwRating: number | null;
   /**
-   * Whether AC system is installed.
+   * True when the building has air conditioning.
    */
   present: boolean;
 };
 
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export const EPCQueryResponseEnergyTariff = {
   Single: "single",
@@ -2130,14 +2131,14 @@ export const EPCQueryResponseEnergyTariff = {
   Unknown: "unknown",
 } as const;
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export type EPCQueryResponseEnergyTariff = OpenEnum<
   typeof EPCQueryResponseEnergyTariff
 >;
 
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export const EPCQueryResponseHeatLossCorridor = {
   NoCorridor: "no_corridor",
@@ -2145,14 +2146,14 @@ export const EPCQueryResponseHeatLossCorridor = {
   UnheatedCorridor: "unheated_corridor",
 } as const;
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export type EPCQueryResponseHeatLossCorridor = OpenEnum<
   typeof EPCQueryResponseHeatLossCorridor
 >;
 
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export const EPCQueryResponseMainFuel = {
   MainsGas: "mains_gas",
@@ -2171,40 +2172,40 @@ export const EPCQueryResponseMainFuel = {
   Other: "other",
 } as const;
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export type EPCQueryResponseMainFuel = OpenEnum<
   typeof EPCQueryResponseMainFuel
 >;
 
 /**
- * Photovoltaic panel installation.
+ * The solar photovoltaic installation.
  */
 export type EPCQueryResponsePhotovoltaic = {
   /**
-   * Whether PV panels are installed.
+   * True when solar photovoltaic panels are installed.
    */
   present: boolean;
   /**
-   * Percentage of demand met by PV. Domestic only (PHOTO_SUPPLY field).
+   * The photovoltaic supply figure recorded on the certificate, as a percentage. Domestic only.
    */
   supplyPercentage: number | null;
 };
 
 /**
- * On-site renewable energy installations.
+ * Renewable energy generated on site.
  */
 export type EPCQueryResponseRenewables = {
   /**
-   * Free-text renewable sources description. Non-domestic only (RENEWABLE_SOURCES field).
+   * The renewable sources in the assessor's own words. Non-domestic only.
    */
   description: string | null;
   /**
-   * Photovoltaic panel installation.
+   * The solar photovoltaic installation.
    */
   photovoltaic: EPCQueryResponsePhotovoltaic | null;
   /**
-   * Solar thermal (hot water) present. Domestic: from SOLAR_WATER_HEATING_FLAG. Non-domestic: derived from RENEWABLE_SOURCES text.
+   * True when the building has solar thermal panels heating its hot water.
    */
   solarThermal: boolean | null;
   /**
@@ -2214,7 +2215,7 @@ export type EPCQueryResponseRenewables = {
 };
 
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export const EPCQueryResponseVentilation = {
   Natural: "natural",
@@ -2222,60 +2223,60 @@ export const EPCQueryResponseVentilation = {
   MechanicalSupplyAndExtract: "mechanical_supply_and_extract",
 } as const;
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export type EPCQueryResponseVentilation = OpenEnum<
   typeof EPCQueryResponseVentilation
 >;
 
 /**
- * Building energy systems — fuel, heating, renewables, ventilation.
+ * The building's energy systems: fuel, heating, renewables and ventilation.
  */
 export type EPCQueryResponseSystems = {
   /**
-   * Air conditioning details. Non-domestic/DEC only; null for domestic.
+   * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
    */
   airConditioning: EPCQueryResponseAirConditioning | null;
   /**
-   * Electricity tariff type. Domestic only.
+   * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
    */
   energyTariff: EPCQueryResponseEnergyTariff | null;
   /**
-   * Corridor heat loss classification. Flats/maisonettes only.
+   * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
    */
   heatLossCorridor: EPCQueryResponseHeatLossCorridor | null;
   /**
-   * Normalised primary fuel type. See mainFuelExternal for raw source text.
+   * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
    */
   mainFuel: EPCQueryResponseMainFuel | null;
   /**
-   * Raw fuel type text from source register. E.g. 'mains gas (not community)', 'electricity (7-hour tariff)', 'Natural Gas'.
+   * The fuel exactly as the certificate words it, for example 'mains gas (not community)' or 'electricity (7-hour tariff)'.
    */
   mainFuelExternal: string | null;
   /**
-   * Heating control system code. Domestic only.
+   * The heating controls recorded on the certificate, as a source code. Domestic only.
    */
   mainHeatingControls: string | null;
   /**
-   * Whether mains gas is connected. Domestic only. Derived from MAINS_GAS_FLAG (Y→true, N→false, blank→null).
+   * True when the property has a mains gas connection. Domestic only; null when the certificate does not say.
    */
   mainsGas: boolean | null;
   /**
-   * On-site renewable energy installations.
+   * Renewable energy generated on site.
    */
   renewables: EPCQueryResponseRenewables;
   /**
-   * Length of unheated corridor in metres. Flats/maisonettes only.
+   * Length of the unheated corridor, in metres. Recorded for flats and maisonettes only.
    */
   unheatedCorridorLength: number | null;
   /**
-   * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+   * How the property is ventilated. Domestic only.
    */
   ventilation: EPCQueryResponseVentilation | null;
 };
 
 /**
- * Normalised transaction type (trigger for assessment).
+ * What prompted the assessment, mapped to a standard set of categories.
  */
 export const EPCQueryResponseTransactionType = {
   MarketedSale: "marketed_sale",
@@ -2291,181 +2292,217 @@ export const EPCQueryResponseTransactionType = {
   Other: "other",
 } as const;
 /**
- * Normalised transaction type (trigger for assessment).
+ * What prompted the assessment, mapped to a standard set of categories.
  */
 export type EPCQueryResponseTransactionType = OpenEnum<
   typeof EPCQueryResponseTransactionType
 >;
 
 /**
- * Unified EPC entity covering domestic, non-domestic, and Display Energy Certificates across England, Wales, and Scotland. Filter by certificateType to narrow to a specific assessment type. Use rating.current.band for cross-type energy efficiency comparisons.
+ * A single Energy Performance Certificate, covering domestic and non-domestic EPCs and Display Energy Certificates across England, Wales and Scotland. Filter on `certificateType` to narrow to one kind, and on `rating.current.band` to compare efficiency across all three.
  */
 export type Data = {
   /**
-   * Standardised address.
+   * The certificate's address, in the same form as the rest of the API.
    */
   address: EPCQueryResponseAddress;
   /**
-   * Assessment methodology: rdsap (existing domestic), sap (new domestic), sbem (non-domestic), dsm (complex non-domestic), operational (DEC).
+   * Which procedure the assessment followed. `rdsap` is the reduced-data procedure for existing dwellings and `sap` the full procedure for new ones; `sbem` covers non-domestic buildings and `dsm` the dynamic simulation modelling used for the most complex of them; `operational` is the metered assessment behind a Display Energy Certificate.
    */
   assessmentMethodology: AssessmentMethodology;
   /**
-   * Non-domestic benchmarks and building classification. Null for domestic.
+   * Benchmarks and complexity classification for non-domestic buildings. Null on domestic certificates.
    */
   benchmarks: Benchmarks | null;
   /**
-   * Tracks the same building across successive assessments. E&W: 12-digit BUILDING_REFERENCE_NUMBER. Scotland: 10-digit SEPCR property identifier (not the same as UPRN).
+   * Reference that ties successive assessments of the same building together. It is issued by the source register and is not a location ID.
    */
   buildingReferenceNumber: string | null;
   /**
-   * Certificate type: domestic, non_domestic, or dec.
+   * What kind of certificate this is. `domestic` and `non_domestic` are Energy Performance Certificates for dwellings and for other buildings; `dec` is a Display Energy Certificate, which rates a public building's measured energy use.
    */
   certificateType: EPCQueryResponseCertificateType;
   /**
-   * ONS constituency code (E&W) or Scottish ward code.
+   * Code for the parliamentary constituency, or on Scottish certificates the electoral ward.
    */
   constituency: string | null;
   /**
-   * Constituency/ward name.
+   * Name of that constituency or ward.
    */
   constituencyLabel: string | null;
   /**
-   * Geographic coordinates. Derived from UPRN match or postcode centroid.
+   * Where the building is. Taken from the matched location where there is one, otherwise the centre of the postcode.
    */
   coordinates: EPCQueryResponseCoordinates | null;
   /**
-   * County name. E&W only.
+   * The county. England and Wales only.
    */
   county: string | null;
   /**
-   * Record creation timestamp (ISO 8601).
+   * When this certificate first appeared in the API, as an ISO 8601 timestamp.
    */
   createdAt: string;
   /**
-   * Scottish Data Zone code. Scotland only.
+   * Code for the Scottish data zone the building sits in. Scotland only.
    */
   dataZone: string | null;
   /**
-   * Domestic property details — construction, rooms, glazing, Scotland-specific fields. Null for non-domestic and DECs.
+   * Details that apply to dwellings only: construction, rooms, glazing and the Scotland-specific measures. Null on non-domestic certificates and Display Energy Certificates.
    */
   domesticDetails: DomesticDetails | null;
   /**
-   * Environmental impact, CO2 emissions, and energy consumption.
+   * Carbon dioxide emissions, environmental impact scores and energy consumption.
    */
   emissions: EPCQueryResponseEmissions;
   /**
-   * Component-level building fabric assessment. Domestic only; null for non-domestic and DECs.
+   * Component-by-component assessment of the building fabric. Domestic only; null on non-domestic certificates and Display Energy Certificates.
    */
   fabric: EPCQueryResponseFabric | null;
   /**
-   * Vepler canonical entity ID.
+   * Identifier for this certificate within the API.
    */
   id: string;
   /**
-   * Date of energy assessment (ISO 8601).
+   * When the assessor inspected the building, as an ISO 8601 date.
    */
   inspectionDate: string;
   /**
-   * ONS local authority code (E&W) or Scottish LA code.
+   * ONS code for the local authority the building sits in.
    */
   localAuthority: string | null;
   /**
-   * Local authority name.
+   * Name of that local authority.
    */
   localAuthorityLabel: string | null;
   /**
-   * UPRN linking this certificate to the Vepler Property Index. Null if not yet matched. Populated by UPRN enrichment pipeline.
+   * Identifier for a single addressable location. In Great Britain this is the Unique Property Reference Number (UPRN). Null when the certificate has not been matched to a location.
    */
   locationId: number | null;
   /**
-   * Date registered with the government (ISO 8601).
+   * When the certificate was lodged on the national register, as an ISO 8601 date.
    */
   lodgementDate: string;
   /**
-   * Derived MEES compliance status (Decision D11). Based on current energy rating band and certificate type. compliant=A-E, at_risk=E, non_compliant=F-G, exempt=non-domestic/DEC.
+   * Whether the building meets the Minimum Energy Efficiency Standard, worked out from the current rating band, the certificate type and the nation. `compliant` covers bands A to D, `non_compliant` bands F and G, and `at_risk` marks band E as lettable today with no headroom under the expected tightening to C. The standard is SI 2015/962, which covers both domestic and non-domestic private rented property in England and Wales but does not extend to Scotland, and which is assessed on an asset rating rather than the operational rating a Display Energy Certificate carries — so Scottish certificates and DECs are `not_applicable`. `exempt` means a registered PRS exemption and appears only on legacy rows; it is never derived from certificate data. `unknown` means there is not enough data to decide.
    */
   meesCompliance: EPCQueryResponseMeesCompliance;
   /**
-   * DEC operational performance from metered energy use. Null for domestic and non-domestic EPCs.
+   * Operational performance taken from the building's metered energy use. Null on domestic and non-domestic certificates.
    */
   operationalPerformance: OperationalPerformance | null;
   /**
-   * Normalised property type. Domestic: house, flat, bungalow, maisonette, park_home. Non-domestic: canonical NCM category (e.g. office_workshop, retail_financial). See EPC_DOMESTIC_PROPERTY_TYPE_VALUES and EPC_NON_DOMESTIC_PROPERTY_TYPE_VALUES.
+   * What kind of building this is, mapped to a standard set of categories. Domestic certificates use `house`, `flat`, `bungalow`, `maisonette` or `park_home`; non-domestic certificates use categories such as `office_workshop`, `retail_financial` and `storage_distribution`. `propertyTypeExternal` carries the wording used on the certificate.
    */
   propertyType: string | null;
   /**
-   * Raw property type text from source register. E.g. 'House', 'A1/A2 Retail and Financial/Professional services', 'Offices and Workshop businesses'.
+   * The property type exactly as the certificate words it, for example 'House' or 'Offices and Workshop businesses'.
    */
   propertyTypeExternal: string | null;
   /**
-   * Energy rating — unified across domestic (SAP), non-domestic (asset), and DEC (operational). Filter on rating.current.band for cross-type comparisons.
+   * The building's energy rating. Every certificate type carries one, so filter on `rating.current.band` to compare efficiency across types.
    */
   rating: EPCQueryResponseRating;
   /**
-   * Improvement recommendations ordered by priority. Domestic: from separate recommendations CSV. Non-domestic Scotland: parsed from pipe-delimited IMPROVEMENT_RECOMMENDATIONS field. Non-domestic E&W: from separate recommendations file.
+   * The improvements recommended on the certificate, in the order they should be carried out. Empty when no recommendations are held for this certificate.
    */
   recommendations: Array<EPCQueryResponseRecommendations>;
   /**
-   * Annual running costs in GBP. Domestic only; null for non-domestic and DECs.
+   * Estimated annual running costs in GBP. Domestic only; null on non-domestic certificates and Display Energy Certificates.
    */
   runningCosts: EPCQueryResponseRunningCosts | null;
   /**
-   * Scotland's native non-domestic rating using Scottish weather data. Null for E&W certificates and domestic certificates.
+   * Scotland's own non-domestic rating, calculated with Scottish weather data. Null on domestic certificates and on England and Wales certificates.
    */
   scotlandNativeRating: ScotlandNativeRating | null;
   /**
-   * Source register: mhclg (England & Wales) or scottish_government (Scotland).
+   * Which national register the certificate came from: `mhclg` for England and Wales, `scottish_government` for Scotland.
    */
   source: EPCQueryResponseSource;
   /**
-   * Original certificate identifier from source register. E&W: LMK_KEY. Scotland domestic: OSG_REFERENCE_NUMBER. Scotland non-domestic: REPORT_REFERENCE_NUMBER.
+   * The certificate's own reference number in the register it came from.
    */
   sourceReference: string;
   /**
-   * Building energy systems — fuel, heating, renewables, ventilation.
+   * The building's energy systems: fuel, heating, renewables and ventilation.
    */
   systems: EPCQueryResponseSystems;
   /**
-   * Total floor area in m². Domestic: total internal floor area. Non-domestic: conditioned floor area.
+   * Floor area of the building, in square metres. Domestic certificates give the total internal floor area; non-domestic certificates give the conditioned floor area.
    */
   totalFloorArea: number | null;
   /**
-   * Normalised transaction type (trigger for assessment).
+   * What prompted the assessment, mapped to a standard set of categories.
    */
   transactionType: EPCQueryResponseTransactionType | null;
   /**
-   * Raw transaction type text from source register.
+   * What prompted the assessment, exactly as the certificate words it.
    */
   transactionTypeExternal: string | null;
   /**
-   * Record last update timestamp (ISO 8601).
+   * When this record was last updated, as an ISO 8601 timestamp.
    */
   updatedAt: string;
   /**
-   * Calculated expiry date. Domestic/non-domestic: lodgementDate + 10 years. DEC: lodgementDate + 1 year (advisory report: + 7 years).
+   * When the certificate expires, as an ISO 8601 date. Energy Performance Certificates run for ten years from lodgement; Display Energy Certificates run for one.
    */
   validUntil: string | null;
 };
 
+/**
+ * Type of this response. Always `list`.
+ */
 export const EPCQueryResponseObject = {
   List: "list",
 } as const;
+/**
+ * Type of this response. Always `list`.
+ */
 export type EPCQueryResponseObject = ClosedEnum<typeof EPCQueryResponseObject>;
 
+/**
+ * Where this page sits in the full result set.
+ */
 export type Pagination = {
+  /**
+   * True when further results exist beyond this page.
+   */
   hasMore: boolean;
+  /**
+   * Total number of results matching the request across all pages.
+   */
   totalCount: number;
 };
 
+/**
+ * The path that produced this list. Always `/v1/epc/query`.
+ */
 export const Url = {
   RootV1EpcQuery: "/v1/epc/query",
 } as const;
+/**
+ * The path that produced this list. Always `/v1/epc/query`.
+ */
 export type Url = ClosedEnum<typeof Url>;
 
+/**
+ * A page of EPC certificates matching the search.
+ */
 export type EPCQueryResponse = {
+  /**
+   * The certificates on this page, in the requested order.
+   */
   data: Array<Data>;
+  /**
+   * Type of this response. Always `list`.
+   */
   object: EPCQueryResponseObject;
+  /**
+   * Where this page sits in the full result set.
+   */
   pagination: Pagination;
+  /**
+   * The path that produced this list. Always `/v1/epc/query`.
+   */
   url: Url;
 };