@vepler/sdk 3.0.0 → 5.28.1

package/src/sdk/models/operations/getepcbylocationid.ts

@@ -11,7 +11,7 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * Filter by certificate type. Omit to return all types.
+ * Return only certificates of this type. Omit to get every type.
  */
 export const CertificateType = {
   Domestic: "domestic",
@@ -19,65 +19,65 @@ export const CertificateType = {
   Dec: "dec",
 } as const;
 /**
- * Filter by certificate type. Omit to return all types.
+ * Return only certificates of this type. Omit to get every type.
  */
 export type CertificateType = ClosedEnum<typeof CertificateType>;
 
 export type GetEpcByLocationIdRequest = {
   /**
-   * Filter by certificate type. Omit to return all types.
+   * Return only certificates of this type. Omit to get every type.
    */
   certificateType?: CertificateType | undefined;
   /**
-   * Maximum records to return (default: 100, max: 1000)
+   * Maximum number of items to return. Defaults to 100. Minimum 1, maximum 1000.
    */
   limit?: string | undefined;
   /**
-   * Unique location identifier (UPRN)
+   * Identifier for a single addressable location. In Great Britain this is the Unique Property Reference Number (UPRN).
    */
   locationId: string;
   /**
-   * Pagination offset (default: 0)
+   * Number of results to skip before the first one returned. Defaults to 0.
    */
   offset?: string | undefined;
 };
 
 /**
- * Standardised address.
+ * The certificate's address, in the same form as the rest of the API.
  */
 export type GetEpcByLocationIdAddress = {
   /**
-   * 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",
@@ -87,12 +87,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",
@@ -103,12 +103,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+",
@@ -126,66 +126,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 GetEpcByLocationIdCertificateType = {
   Domestic: "domestic",
@@ -193,28 +193,28 @@ export const GetEpcByLocationIdCertificateType = {
   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 GetEpcByLocationIdCertificateType = OpenEnum<
   typeof GetEpcByLocationIdCertificateType
 >;
 
 /**
- * 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 Coordinates = {
   /**
-   * 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",
@@ -225,34 +225,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 ConstructionAge = {
   /**
-   * 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 Area = {
   MuchLessThanTypical: "much_less_than_typical",
@@ -262,12 +262,12 @@ export const Area = {
   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 Area = OpenEnum<typeof Area>;
 
 /**
- * Glazing specification.
+ * What kind of glazing is fitted, with double glazing split by whether it was installed before 2002.
  */
 export const GetEpcByLocationIdType = {
   Single: "single",
@@ -280,30 +280,30 @@ export const GetEpcByLocationIdType = {
   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 GetEpcByLocationIdType = OpenEnum<typeof GetEpcByLocationIdType>;
 
 /**
- * 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: Area | 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: GetEpcByLocationIdType | 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 Tenure = {
   OwnerOccupied: "owner_occupied",
@@ -312,172 +312,172 @@ export const Tenure = {
   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 Tenure = OpenEnum<typeof Tenure>;
 
 /**
- * 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: ConstructionAge | 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: Tenure | 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 Co2Unit = {
   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 Co2Unit = OpenEnum<typeof Co2Unit>;
 
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export const EnergyConsumptionUnit = {
   KwhPerYear: "kwh_per_year",
   KwhPerM2PerYear: "kwh_per_m2_per_year",
 } as const;
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export type EnergyConsumptionUnit = OpenEnum<typeof EnergyConsumptionUnit>;
 
 /**
- * Environmental impact, CO2 emissions, and energy consumption.
+ * Carbon dioxide emissions, environmental impact scores and energy consumption.
  */
 export type Emissions = {
   /**
-   * 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: Co2Unit;
   /**
-   * 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: EnergyConsumptionUnit | 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 EnergyEfficiency = {
   VeryGood: "very_good",
@@ -487,12 +487,12 @@ export const EnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EnergyEfficiency = OpenEnum<typeof EnergyEfficiency>;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -502,30 +502,30 @@ export const EnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EnvironmentalEfficiency = OpenEnum<typeof EnvironmentalEfficiency>;
 
 /**
- * Air tightness assessment. Scotland only; null for E&W.
+ * The air tightness assessment. Scotland only; null on England and Wales certificates.
  */
 export type AirTightness = {
   /**
-   * 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: EnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency: EnvironmentalEfficiency | 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 DataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -535,12 +535,12 @@ export const DataQuality = {
   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 DataQuality = OpenEnum<typeof DataQuality>;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export const GetEpcByLocationIdEnergyEfficiency = {
   VeryGood: "very_good",
@@ -550,14 +550,14 @@ export const GetEpcByLocationIdEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export type GetEpcByLocationIdEnergyEfficiency = OpenEnum<
   typeof GetEpcByLocationIdEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEpcByLocationIdEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -567,14 +567,14 @@ export const GetEpcByLocationIdEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEpcByLocationIdEnvironmentalEfficiency = OpenEnum<
   typeof GetEpcByLocationIdEnvironmentalEfficiency
 >;
 
 /**
- * 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 FloorType = {
   Solid: "solid",
@@ -584,12 +584,12 @@ export const FloorType = {
   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 FloorType = OpenEnum<typeof FloorType>;
 
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export const InsulationType = {
   None: "none",
@@ -605,54 +605,54 @@ export const InsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export type InsulationType = OpenEnum<typeof InsulationType>;
 
 /**
- * Ground floor construction and insulation.
+ * The ground floor and its insulation.
  */
 export type Floor = {
   /**
-   * 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: DataQuality | 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: GetEpcByLocationIdEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How the floor scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency: GetEpcByLocationIdEnvironmentalEfficiency | 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: FloorType | 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: InsulationType | 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 GetEPCByLocationIdEPCEnergyEfficiency = {
   VeryGood: "very_good",
@@ -662,14 +662,14 @@ export const GetEPCByLocationIdEPCEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCEnergyEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -679,32 +679,32 @@ export const GetEPCByLocationIdEPCEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCEnvironmentalEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCEnvironmentalEfficiency
 >;
 
 /**
- * Heating control system.
+ * How the heating is controlled.
  */
 export type HeatingControls = {
   /**
-   * 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: GetEPCByLocationIdEPCEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency: GetEPCByLocationIdEPCEnvironmentalEfficiency | null;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponseEnergyEfficiency = {
   VeryGood: "very_good",
@@ -714,14 +714,14 @@ export const GetEPCByLocationIdEPCResponseEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponseEnergyEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCResponseEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponseEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -731,26 +731,26 @@ export const GetEPCByLocationIdEPCResponseEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponseEnvironmentalEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCResponseEnvironmentalEfficiency
 >;
 
 /**
- * Hot water system.
+ * The hot water system.
  */
 export type HotWater = {
   /**
-   * 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: GetEPCByLocationIdEPCResponseEnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponseEnvironmentalEfficiency
@@ -758,7 +758,7 @@ export type HotWater = {
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200EnergyEfficiency = {
   VeryGood: "very_good",
@@ -768,14 +768,14 @@ export const GetEPCByLocationIdEPCResponse200EnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200EnergyEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCResponse200EnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200EnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -785,26 +785,26 @@ export const GetEPCByLocationIdEPCResponse200EnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200EnvironmentalEfficiency = OpenEnum<
   typeof GetEPCByLocationIdEPCResponse200EnvironmentalEfficiency
 >;
 
 /**
- * Lighting system.
+ * The lighting installed.
  */
 export type Lighting = {
   /**
-   * 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: GetEPCByLocationIdEPCResponse200EnergyEfficiency | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200EnvironmentalEfficiency
@@ -812,7 +812,7 @@ export type Lighting = {
 };
 
 /**
- * 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 GetEpcByLocationIdDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -822,14 +822,14 @@ export const GetEpcByLocationIdDataQuality = {
   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 GetEpcByLocationIdDataQuality = OpenEnum<
   typeof GetEpcByLocationIdDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONEnergyEfficiency = {
   VeryGood: "very_good",
@@ -839,7 +839,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONEnergyEfficiency =
   OpenEnum<
@@ -847,7 +847,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONEnergyEfficiency =
   >;
 
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONEnvironmentalEfficiency =
   {
@@ -858,7 +858,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONEnvironmentalEfficie
     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 GetEPCByLocationIdEPCResponse200ApplicationJSONEnvironmentalEfficiency =
   OpenEnum<
@@ -866,7 +866,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONEnvironmentalEfficien
   >;
 
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export const Fuel = {
   MainsGas: "mains_gas",
@@ -885,12 +885,12 @@ export const Fuel = {
   Other: "other",
 } as const;
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export type Fuel = OpenEnum<typeof Fuel>;
 
 /**
- * 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 HeatPumpType = {
   AirSource: "air_source",
@@ -898,12 +898,12 @@ export const HeatPumpType = {
   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 HeatPumpType = OpenEnum<typeof HeatPumpType>;
 
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export const SystemType = {
   BoilerRadiators: "boiler_radiators",
@@ -919,54 +919,54 @@ export const SystemType = {
   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 SystemType = OpenEnum<typeof SystemType>;
 
 /**
- * Main heating system.
+ * The main heating system.
  */
 export type MainHeating = {
   /**
-   * 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: GetEpcByLocationIdDataQuality | 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:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the heating system scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONEnvironmentalEfficiency
     | null;
   /**
-   * Fuel type for this heating system.
+   * The fuel this heating system runs on.
    */
   fuel: Fuel | 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: HeatPumpType | 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: SystemType | 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 GetEPCByLocationIdEPCDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -976,14 +976,14 @@ export const GetEPCByLocationIdEPCDataQuality = {
   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 GetEPCByLocationIdEPCDataQuality = OpenEnum<
   typeof GetEPCByLocationIdEPCDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnergyEfficiency =
   {
@@ -994,7 +994,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnergyEf
     VeryPoor: "very_poor",
   } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnergyEfficiency =
   OpenEnum<
@@ -1002,7 +1002,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnergyEff
   >;
 
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnvironmentalEfficiency =
   {
@@ -1013,7 +1013,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnvironm
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnvironmentalEfficiency =
   OpenEnum<
@@ -1021,7 +1021,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnvironme
   >;
 
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export const GetEpcByLocationIdInsulationType = {
   None: "none",
@@ -1037,14 +1037,14 @@ export const GetEpcByLocationIdInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export type GetEpcByLocationIdInsulationType = OpenEnum<
   typeof GetEpcByLocationIdInsulationType
 >;
 
 /**
- * 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 RoofType = {
   Pitched: "pitched",
@@ -1055,62 +1055,62 @@ export const RoofType = {
   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 RoofType = OpenEnum<typeof RoofType>;
 
 /**
- * Roof construction and insulation.
+ * The roof and its insulation.
  */
 export type Roof = {
   /**
-   * 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: GetEPCByLocationIdEPCDataQuality | 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:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the roof scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyEnvironmentalEfficiency
     | 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: GetEpcByLocationIdInsulationType | 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: RoofType | 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 GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnergyEfficiency =
   {
@@ -1121,7 +1121,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEner
     VeryPoor: "very_poor",
   } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnergyEfficiency =
   OpenEnum<
@@ -1129,7 +1129,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnerg
   >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnvironmentalEfficiency =
   {
@@ -1140,7 +1140,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnvi
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnvironmentalEfficiency =
   OpenEnum<
@@ -1148,21 +1148,21 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnvir
   >;
 
 /**
- * Secondary heating system. Null when no secondary heating is present.
+ * Any secondary heating system. Null when the property has none.
  */
 export type SecondaryHeating = {
   /**
-   * 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:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataEnvironmentalEfficiency
@@ -1170,7 +1170,7 @@ export type SecondaryHeating = {
 };
 
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export const Construction = {
   Cavity: "cavity",
@@ -1188,12 +1188,12 @@ export const Construction = {
   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 Construction = OpenEnum<typeof Construction>;
 
 /**
- * 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 GetEPCByLocationIdEPCResponseDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -1203,14 +1203,14 @@ export const GetEPCByLocationIdEPCResponseDataQuality = {
   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 GetEPCByLocationIdEPCResponseDataQuality = OpenEnum<
   typeof GetEPCByLocationIdEPCResponseDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnergyEfficiency =
   {
@@ -1221,7 +1221,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabr
     VeryPoor: "very_poor",
   } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnergyEfficiency =
   OpenEnum<
@@ -1229,7 +1229,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabri
   >;
 
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnvironmentalEfficiency =
   {
@@ -1240,7 +1240,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabr
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnvironmentalEfficiency =
   OpenEnum<
@@ -1248,7 +1248,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabri
   >;
 
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export const GetEPCByLocationIdEPCInsulationType = {
   None: "none",
@@ -1264,64 +1264,64 @@ export const GetEPCByLocationIdEPCInsulationType = {
   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 GetEPCByLocationIdEPCInsulationType = OpenEnum<
   typeof GetEPCByLocationIdEPCInsulationType
 >;
 
 /**
- * External wall construction and insulation.
+ * The external walls and their insulation.
  */
 export type Walls = {
   /**
-   * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+   * How the external walls are built.
    */
   construction: Construction | 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: GetEPCByLocationIdEPCResponseDataQuality | 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:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How the walls score for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricEnvironmentalEfficiency
     | 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: GetEPCByLocationIdEPCInsulationType | 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 GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnergyEfficiency =
   {
@@ -1332,7 +1332,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabr
     VeryPoor: "very_poor",
   } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnergyEfficiency =
   OpenEnum<
@@ -1340,7 +1340,7 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabri
   >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnvironmentalEfficiency =
   {
@@ -1351,7 +1351,7 @@ export const GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabr
     VeryPoor: "very_poor",
   } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnvironmentalEfficiency =
   OpenEnum<
@@ -1359,21 +1359,21 @@ export type GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabri
   >;
 
 /**
- * Window glazing specification.
+ * The windows and their glazing.
  */
 export type Windows = {
   /**
-   * 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:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnergyEfficiency
     | null;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency:
     | GetEPCByLocationIdEPCResponse200ApplicationJSONResponseBodyDataFabricWindowsEnvironmentalEfficiency
@@ -1381,63 +1381,64 @@ export type Windows = {
 };
 
 /**
- * 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 Fabric = {
   /**
-   * Air tightness assessment. Scotland only; null for E&W.
+   * The air tightness assessment. Scotland only; null on England and Wales certificates.
    */
   airTightness: AirTightness | null;
   /**
-   * Ground floor construction and insulation.
+   * The ground floor and its insulation.
    */
   floor: Floor;
   /**
-   * Heating control system.
+   * How the heating is controlled.
    */
   heatingControls: HeatingControls;
   /**
-   * Hot water system.
+   * The hot water system.
    */
   hotWater: HotWater;
   /**
-   * Lighting system.
+   * The lighting installed.
    */
   lighting: Lighting;
   /**
-   * Main heating system.
+   * The main heating system.
    */
   mainHeating: MainHeating;
   /**
-   * Roof construction and insulation.
+   * The roof and its insulation.
    */
   roof: Roof;
   /**
-   * Secondary heating system. Null when no secondary heating is present.
+   * Any secondary heating system. Null when the property has none.
    */
   secondaryHeating: SecondaryHeating | null;
   /**
-   * External wall construction and insulation.
+   * The external walls and their insulation.
    */
   walls: Walls;
   /**
-   * Window glazing specification.
+   * The windows and their glazing.
    */
   windows: Windows;
 };
 
 /**
- * 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 MeesCompliance = {
   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 MeesCompliance = OpenEnum<typeof MeesCompliance>;
 
@@ -1475,21 +1476,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+",
@@ -1507,84 +1508,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 Band = {
   APlus: "A+",
@@ -1602,12 +1603,12 @@ export const Band = {
   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 Band = OpenEnum<typeof Band>;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const ScoreType = {
   Sap: "sap",
@@ -1616,30 +1617,30 @@ export const ScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type ScoreType = OpenEnum<typeof ScoreType>;
 
 /**
- * Current energy rating at time of assessment.
+ * The rating the building holds as assessed.
  */
 export type Current = {
   /**
-   * 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: Band;
   /**
-   * 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: ScoreType;
 };
 
 /**
- * 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 GetEpcByLocationIdBand = {
   APlus: "A+",
@@ -1657,12 +1658,12 @@ export const GetEpcByLocationIdBand = {
   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 GetEpcByLocationIdBand = OpenEnum<typeof GetEpcByLocationIdBand>;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const GetEpcByLocationIdScoreType = {
   Sap: "sap",
@@ -1671,50 +1672,50 @@ export const GetEpcByLocationIdScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type GetEpcByLocationIdScoreType = OpenEnum<
   typeof GetEpcByLocationIdScoreType
 >;
 
 /**
- * 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 Potential = {
   /**
-   * 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: GetEpcByLocationIdBand;
   /**
-   * 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: GetEpcByLocationIdScoreType;
 };
 
 /**
- * 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 GetEpcByLocationIdRating = {
   /**
-   * 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: Current;
   /**
-   * 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: Potential | null;
 };
 
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export const GetEpcByLocationIdCategory = {
   Insulation: "insulation",
@@ -1725,14 +1726,14 @@ export const GetEpcByLocationIdCategory = {
   Lighting: "lighting",
 } as const;
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export type GetEpcByLocationIdCategory = OpenEnum<
   typeof GetEpcByLocationIdCategory
 >;
 
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export const Co2Impact = {
   Low: "low",
@@ -1740,49 +1741,49 @@ export const Co2Impact = {
   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 Co2Impact = OpenEnum<typeof Co2Impact>;
 
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export const Currency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export type Currency = ClosedEnum<typeof Currency>;
 
 /**
- * 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 Cost = {
   /**
-   * Currency. All values normalised to GBP.
+   * The currency of the cost figures. Always `GBP`.
    */
   currency: Currency;
   /**
-   * 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 Measure = {
   WallInsulation: "wall_insulation",
@@ -1827,12 +1828,12 @@ export const Measure = {
   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 Measure = OpenEnum<typeof Measure>;
 
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export const PaybackType = {
   Short: "short",
@@ -1841,171 +1842,171 @@ export const PaybackType = {
   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 PaybackType = OpenEnum<typeof PaybackType>;
 
 /**
- * Projected rating after this measure. Domestic only.
+ * The rating reached once this measure is carried out. Domestic only.
  */
 export type ProjectedRating = {
   /**
-   * 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 GetEpcByLocationIdCurrency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export type GetEpcByLocationIdCurrency = ClosedEnum<
   typeof GetEpcByLocationIdCurrency
 >;
 
 /**
- * Estimated annual saving in GBP. Parsed from source typical saving field.
+ * What the measure is estimated to save each year, in GBP.
  */
 export type Saving = {
   /**
-   * Estimated annual saving (£ GBP).
+   * Estimated saving each year, in GBP.
    */
   annual: number | null;
   /**
-   * Currency.
+   * The currency of the saving. Always `GBP`.
    */
   currency: GetEpcByLocationIdCurrency;
 };
 
 /**
- * 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 Recommendations = {
   /**
-   * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+   * What kind of improvement the measure is.
    */
   category: GetEpcByLocationIdCategory | null;
   /**
-   * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+   * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
    */
   co2Impact: Co2Impact | 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: Cost | 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: Measure | 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: PaybackType | null;
   /**
-   * Projected rating after this measure. Domestic only.
+   * The rating reached once this measure is carried out. Domestic only.
    */
   projectedRating: ProjectedRating | null;
   /**
-   * Estimated annual saving in GBP. Parsed from source typical saving field.
+   * What the measure is estimated to save each year, in GBP.
    */
   saving: Saving | 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 Heating = {
   /**
-   * 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 GetEpcByLocationIdHotWater = {
   /**
-   * 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 GetEpcByLocationIdLighting = {
   /**
-   * 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 RunningCosts = {
   /**
-   * Annual heating costs — current and achievable.
+   * Estimated annual heating cost, as assessed and after improvement.
    */
   heating: Heating;
   /**
-   * Annual hot water costs — current and achievable.
+   * Estimated annual hot water cost, as assessed and after improvement.
    */
   hotWater: GetEpcByLocationIdHotWater;
   /**
-   * Annual lighting costs — current and achievable.
+   * Estimated annual lighting cost, as assessed and after improvement.
    */
   lighting: GetEpcByLocationIdLighting;
 };
 
 /**
- * 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+",
@@ -2023,12 +2024,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+",
@@ -2046,46 +2047,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 Source = {
   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 Source = OpenEnum<typeof Source>;
 
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export const InspectionStatus = {
   Completed: "completed",
@@ -2095,34 +2096,34 @@ export const InspectionStatus = {
   Unknown: "unknown",
 } as const;
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export type InspectionStatus = OpenEnum<typeof InspectionStatus>;
 
 /**
- * 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 AirConditioning = {
   /**
-   * 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: InspectionStatus | 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 EnergyTariff = {
   Single: "single",
@@ -2134,12 +2135,12 @@ export const EnergyTariff = {
   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 EnergyTariff = OpenEnum<typeof EnergyTariff>;
 
 /**
- * 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 HeatLossCorridor = {
   NoCorridor: "no_corridor",
@@ -2147,12 +2148,12 @@ export const HeatLossCorridor = {
   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 HeatLossCorridor = OpenEnum<typeof HeatLossCorridor>;
 
 /**
- * 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 MainFuel = {
   MainsGas: "mains_gas",
@@ -2171,38 +2172,38 @@ export const MainFuel = {
   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 MainFuel = OpenEnum<typeof MainFuel>;
 
 /**
- * Photovoltaic panel installation.
+ * The solar photovoltaic installation.
  */
 export type Photovoltaic = {
   /**
-   * 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 Renewables = {
   /**
-   * 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: Photovoltaic | 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;
   /**
@@ -2212,7 +2213,7 @@ export type Renewables = {
 };
 
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export const Ventilation = {
   Natural: "natural",
@@ -2220,58 +2221,58 @@ export const Ventilation = {
   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 Ventilation = OpenEnum<typeof Ventilation>;
 
 /**
- * Building energy systems — fuel, heating, renewables, ventilation.
+ * The building's energy systems: fuel, heating, renewables and ventilation.
  */
 export type Systems = {
   /**
-   * 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: AirConditioning | null;
   /**
-   * Electricity tariff type. Domestic only.
+   * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
    */
   energyTariff: EnergyTariff | 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: HeatLossCorridor | 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: MainFuel | 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: Renewables;
   /**
-   * 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: Ventilation | null;
 };
 
 /**
- * Normalised transaction type (trigger for assessment).
+ * What prompted the assessment, mapped to a standard set of categories.
  */
 export const TransactionType = {
   MarketedSale: "marketed_sale",
@@ -2287,175 +2288,196 @@ export const TransactionType = {
   Other: "other",
 } as const;
 /**
- * Normalised transaction type (trigger for assessment).
+ * What prompted the assessment, mapped to a standard set of categories.
  */
 export type TransactionType = OpenEnum<typeof TransactionType>;
 
 /**
- * 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 GetEpcByLocationIdData = {
   /**
-   * Standardised address.
+   * The certificate's address, in the same form as the rest of the API.
    */
   address: GetEpcByLocationIdAddress;
   /**
-   * 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: GetEpcByLocationIdCertificateType;
   /**
-   * 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: Coordinates | 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: Emissions;
   /**
-   * 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: Fabric | 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: MeesCompliance;
   /**
-   * 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: GetEpcByLocationIdRating;
   /**
-   * 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<Recommendations>;
   /**
-   * 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: RunningCosts | 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: Source;
   /**
-   * 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: Systems;
   /**
-   * 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: TransactionType | 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 GetEpcByLocationIdObject = {
   List: "list",
 } as const;
+/**
+ * Type of this response. Always `list`.
+ */
 export type GetEpcByLocationIdObject = ClosedEnum<
   typeof GetEpcByLocationIdObject
 >;
 
 /**
- * EPC certificates for this location
+ * The EPC certificates held for this location.
  */
 export type GetEpcByLocationIdResponseBody = {
+  /**
+   * The certificates on this page, most recently lodged first.
+   */
   data: Array<GetEpcByLocationIdData>;
+  /**
+   * True when further results exist beyond this page.
+   */
   hasMore: boolean;
+  /**
+   * Type of this response. Always `list`.
+   */
   object: GetEpcByLocationIdObject;
+  /**
+   * Total number of results matching the request across all pages.
+   */
   totalCount?: number | undefined;
+  /**
+   * The path that produced this list.
+   */
   url: string;
 };