Skip to content

Energy model

The PropEco energy model leverages the power of dynamic modelling to provide highly accurate projections of the energy use and carbon footprint of residential properties.

The model addresses many of the limitations of commonly used methodologies such as SAP (which underpins EPC assessments) and enables you to factor-in a wide range of considerations including property attributes (size, type, age, level of insulation etc), local climatic conditions, occupancy levels and usage patterns.

Projections are provided as aggregate figures, and also broken-down by month and use (space heating, water heating and lighting).

You can access, test and subscribe to the API at www.propeco.io/api.


POST /energy-model

📄❓ See Code Samples (page bottom) for an example request.

The API generates an estimate of the annual and monthly energy requirements of a property, based on parameters relating to building features, location and usage patterns.

Request Body Parameters

   {
        "location",
        "building_type",
        "construction_year",
        "building_age_band",
        "primary_fuel",
        "options": {
            "total_floor_area",
            "number_of_occupants",
            "main_heating_efficiency",
            "water_heating_efficiency",
            "low_energy_lighting_proportion",
            "building_characteristics": {
                "exposure_value",
                "insulation_value",
                "air_leakage_value",
                "capacity_value",
                "solar_ingress_value",
                "occupancy_value",
                "living_area_value"
                }
            }
    }

location string Required

The location in which the property resides. This can either be:

  • A valid UK postcode
  • One of the following region names:
    • "Borders"
    • "East Anglia"
    • "East Pennines"
    • "East Scotland"
    • "Highlands"
    • "Midlands"
    • "N Ireland"
    • "NE England"
    • "NE Scotland"
    • "NW England"
    • "Orkney"
    • "SE England"
    • "Severn"
    • "Shetland"
    • "South England"
    • "SW England"
    • "SW Scotland"
    • "Thames"
    • "Wales"
    • "West Pennines"
    • "West Scotland"
    • "Western Isles"

building_type string Required

The type of building. This can be one of the following:

  • "Detached"
  • "Semi-detached"
  • "Flat"
  • "Terraced"
  • "Tenement"
  • "4-in-block"
  • "Tower/Slab"
  • "Conversion”

construction_year integer Optional*

The year in which the building was constructed. This will be used to assign an age band to the building for calculations.

building_age_band integer Optional*

The age band of the building based on construction year. This can be one of the following:

  • "before 1900"
  • "1900-1929"
  • "1930-1949"
  • "1950-1966"
  • "1967-1975"
  • "1976-1982"
  • "1983-1990"
  • "1991-1995"
  • "1996-2002"
  • "2003-2006"
  • "2007-2011"
  • "2012 onwards"

*One of the following must be provided:

  • A construciton_year.
  • A building_age_band.

Options

primary_fuel string Optional

This can be one of the following:

  • "Anthracite"
  • "B30K"
  • "Biodiesel"
  • "Bioethanol"
  • "Biogas"
  • "Bottled Gas"
  • "Dual Fuel Anthracite Wood"
  • "Electricity"
  • "House Coal"
  • "Lpg"
  • "Lpg Special"
  • "Mains Gas"
  • "Mineral Oil"
  • "Oil"
  • "Rapeseed Oil"
  • "Smokeless Fuel"
  • "Wood Chips"
  • "Wood Logs"
  • "Wood Pellets Bulk"
  • "Wood Pellets In Bags"

The model will use the primary fuel type to estimate energy costs and the carbon footprint of the property, based on up-to-date market data.

If no primary fuel type is provided, "Mains Gas" is assumed.

total_floor_area number Optional

A numerical value representing the total floor area of the property in m². If not provided, a default value will be used based on the building type selected.

number_of_occupants number Optional

Integer value representing the number of people that live/reside/work in the given property. If not provided, a value will be derived from the total floor area of the property.

main_heating_efficiency number Optional

Float between 0 and 1 representing the efficiency of the main heating system. In most cases, this is also the property’s only heating system. This affects the calculation of how much energy is required to heat the property.

Note: This is NOT the overall space heating efficiency for the property. This is only the efficiency of the main heating unit itself, and does not account for losses outside of the heating unit.

If not provided, a default value will be used based on the building characteristics.

water_heating_efficiency number Optional

Float between 0 and 1 representing the efficiency of the water heating system. This affects the calculation of how much energy is required to meet water heating demand.

Note: This is NOT the overall water heating efficiency for the property. This is only the efficiency of the water heating unit itself, and does not account for losses outside of the water heating unit.

low_energy_lighting_proportion number Optional

Float between 0 and 1 representing the fraction of lighting in the property that is low energy (50% energy consumption of “high” energy lighting). This affects the lighting energy demand for the property.

Building Characteristics

These are optional - any characteristics that are not provided will be determined by the building type specified.

Note that building characteristics can be used to estimate the impact of improvements on the building. For example, a building with insulation_value:2 can be re-evaluated with insulation_value:3 to estimate the impact of improving its insulation.

The characteristics that can be specified are:

exposure_value integer Optional

An integer (between 1 and 5) representing how exposed the property is to wind and other weather features. Essentially, it describes how many other objects (buildings, trees, etc) surround the property. Higher values indicate fewer surroundings to block wind.

insulation_value integer Optional

An integer (between 1 and 5) representing how well insulated the property is. Higher values indicate better insulation.

air_leakage_value integer Optional

An integer (between 1 and 5) representing how much air and subsequently heat is lost from the property to the surrounding environment over time. Higher values indicate worse air tightness and higher air leakage.

capacity_value integer Optional

An integer (between 1 and 2) representing the thermal mass of the property. In essence, this describes how much internal volume there is in the property. Higher values indicate more volume / larger thermal mass.

solar_ingress_value integer Optional

An integer (between 1 and 3) representing the amount of sunlight that enters the property through windows. Higher values indicate more sunlight entering the property.

occupancy_value integer Optional

An integer (between 1 and 5) representing how much time occupants spend in the property. Higher values indicate the the property is in-use for more of the time.

living_area_value integer Optional

An integer (between 1 and 5) representing how much of the property is heated. (Particularly in large properties, occupants often opt to heat only the rooms that they use.) Higher values indicate that more of the property is heated.


Response

📄❓ See Code Samples (page bottom) for an example response.

The API provides in-depth energy use projections for the property as a JS object. This comprises:

Parameters

"parameters": {
    "location": "PL26 6BJ",
    "building_type": "Flat",
    "construction_year": 1999,
    "total_floor_area": 60,
    "number_of_occupants": 2,
    "main_heating_efficiency": 0.95,
    "water_heating_efficiency": 0.8,
    "low_energy_lighting_proportion": 0.8,
    "primary_fuel": "Mains Gas",
    "building_characteristics": {
        "exposure_value": 2,
        "insulation_value": 2,
        "air_leakage_value": 3,
        "capacity_value": 1,
        "solar_ingress_value": 3,
        "occupancy_value": 3,
        "living_area_value": 1
    }
},

An object containing the input data that has been used in the calculation (either provided or assumed).

Total Energy Usage

"total_energy_usage": 11653.68966858319

An estimate of the total energy (kWh) required each year for space heating, water heating and lighting.

Space Heating Energy Usage

"space_heating_annual": 8409.594079899702,
"space_heating_monthly": [
    643.9847552511013, 1309.310021100477, 1229.662626345974,
    1228.050438609078, 699.9699068502468, 77.90428164505957, 0, 0,
    106.65443821546118, 415.6413262885649, 1036.1999087834981,
    1662.21637681024
],

Annual and monthly estimates of the energy (kWh) required to heat the property.

Space Heating Energy Usage

"hot_water_annual": 2915.4399880138894,
"hot_water_monthly": [
    277.4475252777778, 255.40572766666668, 260.311606625, 239.97717,
    234.3788877222222, 216.18722291666668, 207.78679666666667,
    223.44106730555558, 224.8954395833333, 245.27792154166667,
    258.4295808333334, 271.90104187500003
],

Annual and monthly estimates of the energy (kWh) required to provide hot water at the property.

Lighting Energy Usage

"lighting_annual": 328.655600669599,
"lighting_monthly": [
    36.57989897437029, 32.70590453870206, 28.45625003654479,
    23.66658418880953, 19.557802211585653, 17.18644804187359,
    18.196034470562882, 21.83524136467546, 26.413598425010637,
    30.99195548534581, 35.335525004125344, 37.73035792799297
],

Annual and monthly estimates of the energy (kWh) required to light the property. Note that the variation in monthly figures reflects changes in available daylight.

Primary Fuel Usage

Price

"primary_fuel_price_per_kwh": 0.08

The price per kilowatt hour (kWh) of the property's primary fuel source. Note that if the primary fuel source is electricity, this will be equal to electricity_price_per_kwh

CO2 Equivalent

"primary_fuel_co2_equivalent_per_kwh": 0.2

The amount of CO2 (or equivalent) emissions (kg) that will be released for every kWh generated by the primary fuel source. This metric is often used to compare the environmental impact of different fuel sources.

Note that if the primary fuel source is electricity, this will be equal to electricity_co2_equivalent_per_kwh

Usage

"primary_fuel_usage_annual": 11325.03406791359,
"primary_fuel_usage_monthly": [
    921.4322805288791, 1564.7157487671436, 1489.974232970974,
    1468.027608609078, 934.348794572469, 294.09150456172625,
    207.78679666666667, 223.44106730555558, 331.5498777987945,
    660.9192478302316, 1294.6294896168315, 1934.11741868524
],

Annual and monthly estimates of the total energy (kWh) that will be generated by the property's primary fuel.

Note that if the primary fuel source is electricity, these values will be equal to electricity_usage_annual and electricity_usage_monthly.

Cost

"primary_fuel_cost_annual": 1012.2177254330871,
"primary_fuel_cost_monthly": [
    82.73558244231033, 133.3252599013715, 128.21893863767792,
    126.17220868872624, 83.76890356579753, 32.2573203649381,
    25.64394373333333, 26.896285384444447, 35.25399022390356,
    61.89453982641853, 112.30035916934652, 163.75039349481918
],

Annual and monthly estimates of cost of the property's primary fuel usage.

Note that if the primary fuel source is electricity, these values will be equal to electricity_cost_annual and electricity_cost_monthly.

Standing Charges

"primary_fuel_standing_charges_annual": 106.215,
"primary_fuel_standing_charges_monthly": [
    9.020999999999999, 8.148, 9.020999999999999, 8.729999999999999,
    9.020999999999999, 8.729999999999999, 9.020999999999999,
    9.020999999999999, 8.729999999999999, 9.020999999999999,
    8.729999999999999, 9.020999999999999
],

Annual and monthly estimates of the standing charge tied to the property's primary fuel (based on national averages).

Note that if the primary fuel source is electricity, these values will be equal to electricity_standing_charges_annual and electricity_standing_charges_monthly.

Emissions

"primary_fuel_co2_equivalent_annual": 2265.006813582718,
"primary_fuel_co2_equivalent_monthly": [
    184.28645610577584, 312.94314975342877, 297.9948465941948,
    293.6055217218156, 186.86975891449381, 58.81830091234525,
    41.55735933333334, 44.68821346111112, 66.30997555975891,
    132.18384956604632, 258.92589792336634, 386.82348373704804
],

Annual and monthly estimates of the CO2 emissions (kg) resulting from the property's primary fuel consumption.

Note that if the primary fuel source is electricity, these values will be equal to electricity_co2_equivalent_annual and electricity_co2_equivalent_monthly.

Electricity Usage

Price

"electricity_price_per_kwh": 0.30

The price per kilowatt hour (kWh) of electricity. Note that if the primary fuel source is electricity, this will be equal to primary_fuel_price_per_kwh

CO2 Equivalent

"electricity_co2_equivalent_per_kwh": 0.21

The amount of CO2 (or equivalent) emissions (kg) that will be released for every kWh of electricity consumed. This metric is often used to compare the environmental impact of different fuel sources.

Note that if the primary fuel source is electricity, this will be equal to primary_fuel_co2_equivalent_per_kwh

Usage

"electricity_usage_annual": 11325.03406791359,
"electricity_usage_monthly": [
    921.4322805288791, 1564.7157487671436, 1489.974232970974,
    1468.027608609078, 934.348794572469, 294.09150456172625,
    207.78679666666667, 223.44106730555558, 331.5498777987945,
    660.9192478302316, 1294.6294896168315, 1934.11741868524
],

Annual and monthly estimates of the total amount of electricity (kWh) that will be used at the property.

Note that if the primary fuel source is electricity, these values will be equal to primary_fuel_usage_annual and primary_fuel_usage_monthly.

Cost

"electricity_cost_annual": 1012.2177254330871,
"electricity_cost_monthly": [
    82.73558244231033, 133.3252599013715, 128.21893863767792,
    126.17220868872624, 83.76890356579753, 32.2573203649381,
    25.64394373333333, 26.896285384444447, 35.25399022390356,
    61.89453982641853, 112.30035916934652, 163.75039349481918
],

Annual and monthly estimates of the total cost of the electricity (kWh) that will be used at the property.

Note that if the primary fuel source is electricity, these values will be equal to primary_fuel_cost_annual and primary_fuel_cost_monthly.

Standing Charges

"electricity_standing_charges_annual": 106.215,
"electricity_standing_charges_monthly": [
    9.020999999999999, 8.148, 9.020999999999999, 8.729999999999999,
    9.020999999999999, 8.729999999999999, 9.020999999999999,
    9.020999999999999, 8.729999999999999, 9.020999999999999,
    8.729999999999999, 9.020999999999999
],

Annual and monthly estimates of the standing charge tied to the property's electricity use (based on national averages).

Note that if the primary fuel source is electricity, these values will be equal to primary_fuel_standing_charges_annual and primary_fuel_standing_charges_monthly.

Emissions

"electricity_co2_equivalent_annual": 2265.006813582718,
"electricity_co2_equivalent_monthly": [
    184.28645610577584, 312.94314975342877, 297.9948465941948,
    293.6055217218156, 186.86975891449381, 58.81830091234525,
    41.55735933333334, 44.68821346111112, 66.30997555975891,
    132.18384956604632, 258.92589792336634, 386.82348373704804
],

Annual and monthly estimates of the CO2 emissions (kg) resulting from the property's electricity consumption.

Note that if the primary fuel source is electricity, these values will be equal to primary_fuel_co2_equivalent_annual and primary_fuel_co2_equivalent_monthly.

Total Cost

"total_cost_annual": 1304.264405633967,
"total_cost_monthly": [
    110.13955213462143, 157.97703126298214, 153.18581364864136,
    149.1721839453691, 106.06624422927322, 53.31325477750018,
    47.53275407450219, 49.87685779384708, 59.078069751406744,
    87.62212647202227, 138.80101667058412, 191.49950087321707
],

Annual and monthly estimates of total energy costs for the property.

Total Standing Charges

"total_standing_charges_annual": 299.665,
"total_standing_charges_monthly": [
    25.451, 22.988, 25.451, 24.63, 25.451, 24.63, 25.451, 25.451, 24.63,
    25.451, 24.63, 25.451
],

Annual and monthly estimates of total energy standing charges for the property.

Total Emissions

"total_co2_equivalent_annual": 2334.0244897233338,
"total_co2_equivalent_monthly": [
    191.9682348903936, 319.8113897065562, 303.9706591018692,
    298.5755044014656, 190.9768973789268, 62.4274550011387,
    45.37852657215154, 49.27361414769297, 71.85683122901115,
    138.69216021796893, 266.34635817423265, 394.74685890192654
]

Annual and monthly estimates of the property's total CO2 emissions (kg).

Code Samples

Request

curl \
  -X GET \
  --header "x-api-key: <API KEY>" \
  --header "Content-Type: application/json" \
  --data '<REQUEST BODY>' \
  https://api.propeco.io/energy-model
const results = await fetch(`https://api.propeco.io/energy-model `, {
    method: "POST",
    headers: {
        "x-api-key": API_KEY
    },
    body: JSON.stringify(requestBody)
  });
const data = await results.json();
{
    "location": "PL26 6BJ",
    "building_type": "Flat",
    "construction_year": 1999,
    "options": {
        "primary_fuel": "Mains Gas",
        "total_floor_area": 60,
        "number_of_occupants": 2,
        "main_heating_efficiency": 0.95,
        "water_heating_efficiency": 0.8,
        "low_energy_lighting_proportion": 0.8,
        "building_characteristics": {
            "exposure_value": 2,
            "insulation_value": 2,
            "air_leakage_value": 3,
            "capacity_value": 1,
            "solar_ingress_value": 3,
            "occupancy_value": 3,
            "living_area_value": 1
        }
    }
}
{
    "title": "Energy Model Parameters",
    "description": "Input parameters for the energy model.",
    "type": "object",
    "properties": {
        "location": {
            "type": "string",
            "description": "The location in which the property resides. Can be one of the following: A valid UK postcode or a UK region name."
        },
        "building_type": {
            "type": "string",
            "description": "The type of building to use. Can be one of the following: Detached, Semi-detached, Terraced, Tenement, 4-in-block, Tower/Slab, Flat, Conversion"
        },
        "construction_year": {
            "type": "integer",
            "description": "The year in which the building was constructed."
        },
        "building_age_band": {
            "type": "string",
            "description": "The age band of the building according to its construction year."
        },
        "options": {
            "type": "object",
            "description": "Optional parameters for the energy model",
            "properties": {
                "primary_fuel": {
                    "type": "string",
                    "description": "The primary fuel type used to heat the building"
                },
                "total_floor_area": {
                    "type": "number",
                    "description": "Numerical value representing the total floor area of the property in m²."
                },
                "number_of_occupants": {
                    "type": "integer",
                    "description": "Integer value representing the number of people that live/reside/work in the given property."
                },
                "main_heating_efficiency": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the efficiency of the main heating system"
                },
                "water_heating_efficiency": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the efficiency of the water heating system."
                },
                "low_energy_lighting_proportion": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the fraction of lighting in the property that is low energy (50% energy consumption of “high” energy lighting)."
                },
                "building_characteristics": {
                    "type": "object",
                    "properties": {
                        "exposure_value": {
                            "type": "integer",
                            "description": "How exposed the property is to wind, etc. Approximately describes how many other objects (buildings, trees, etc) surround the property. 1-5"
                        },
                        "insulation_value": {
                            "type": "integer",
                            "description": "How well insulated the property is. Higher values indicate more insulation. 1-5"
                        },
                        "air_leakage_value": {
                            "type": "integer",
                            "description": "How much air and subsequently heat is lost from the property to the surrounding environment over time. Higher values indicate worse air tightness and higher air leakage. 1-5"
                        },
                        "capacity_value": {
                            "type": "integer",
                            "description": "Thermal mass of the property. Approximately describes how much internal volume there is in the property. Higher values indicate more volume / larger thermal mass. 1-2"
                        },
                        "solar_ingress_value": {
                            "type": "integer",
                            "description": "Amount of sunlight that enters the property through windows. Higher values indicate more sunlight entering the property. 1-3"
                        },
                        "occupancy_value": {
                            "type": "integer",
                            "description": "How many people live in the property. Higher values indicate more people. 1-5"
                        },
                        "living_area_value": {
                            "type": "integer",
                            "description": "How much of the internal space of the property is liveable (insulated, heated). 1-5"
                        }
                    }
                }
            }
        }
    },
    "required": ["location", "building_type"]
}

Response

{
    "parameters": {
        "location": "PL26 6BJ",
        "building_type": "Flat",
        "construction_year": 1999,
        "total_floor_area": 60,
        "number_of_occupants": 2,
        "main_heating_efficiency": 0.95,
        "water_heating_efficiency": 0.8,
        "low_energy_lighting_proportion": 0.8,
        "primary_fuel": "Mains Gas",
        "building_characteristics": {
            "exposure_value": 2,
            "insulation_value": 2,
            "air_leakage_value": 3,
            "capacity_value": 1,
            "solar_ingress_value": 3,
            "occupancy_value": 3,
            "living_area_value": 1
        }
    },
    "total_energy_usage": 11653.68966858319,
    "space_heating_annual": 8409.594079899702,
    "space_heating_monthly": [
        643.9847552511013, 1309.310021100477, 1229.662626345974,
        1228.050438609078, 699.9699068502468, 77.90428164505957, 0, 0,
        106.65443821546118, 415.6413262885649, 1036.1999087834981,
        1662.21637681024
    ],
    "hot_water_annual": 2915.4399880138894,
    "hot_water_monthly": [
        277.4475252777778, 255.40572766666668, 260.311606625, 239.97717,
        234.3788877222222, 216.18722291666668, 207.78679666666667,
        223.44106730555558, 224.8954395833333, 245.27792154166667,
        258.4295808333334, 271.90104187500003
    ],
    "lighting_annual": 328.655600669599,
    "lighting_monthly": [
        36.57989897437029, 32.70590453870206, 28.45625003654479,
        23.66658418880953, 19.557802211585653, 17.18644804187359,
        18.196034470562882, 21.83524136467546, 26.413598425010637,
        30.99195548534581, 35.335525004125344, 37.73035792799297
    ],
    "primary_fuel_price_per_kwh": 0.08,
    "primary_fuel_co2_equivalent_per_kwh": 0.2,
    "primary_fuel_usage_annual": 11325.03406791359,
    "primary_fuel_usage_monthly": [
        921.4322805288791, 1564.7157487671436, 1489.974232970974,
        1468.027608609078, 934.348794572469, 294.09150456172625,
        207.78679666666667, 223.44106730555558, 331.5498777987945,
        660.9192478302316, 1294.6294896168315, 1934.11741868524
    ],
    "primary_fuel_cost_annual": 1012.2177254330871,
    "primary_fuel_cost_monthly": [
        82.73558244231033, 133.3252599013715, 128.21893863767792,
        126.17220868872624, 83.76890356579753, 32.2573203649381,
        25.64394373333333, 26.896285384444447, 35.25399022390356,
        61.89453982641853, 112.30035916934652, 163.75039349481918
    ],
    "primary_fuel_standing_charges_annual": 106.215,
    "primary_fuel_standing_charges_monthly": [
        9.020999999999999, 8.148, 9.020999999999999, 8.729999999999999,
        9.020999999999999, 8.729999999999999, 9.020999999999999,
        9.020999999999999, 8.729999999999999, 9.020999999999999,
        8.729999999999999, 9.020999999999999
    ],
    "primary_fuel_co2_equivalent_annual": 2265.006813582718,
    "primary_fuel_co2_equivalent_monthly": [
        184.28645610577584, 312.94314975342877, 297.9948465941948,
        293.6055217218156, 186.86975891449381, 58.81830091234525,
        41.55735933333334, 44.68821346111112, 66.30997555975891,
        132.18384956604632, 258.92589792336634, 386.82348373704804
    ],
    "electricity_price_per_kwh": 0.3,
    "electricity_co2_equivalent_per_kwh": 0.21,
    "electricity_usage_annual": 328.65560066959904,
    "electricity_usage_monthly": [
        36.57989897437029, 32.70590453870206, 28.45625003654479,
        23.66658418880953, 19.557802211585653, 17.18644804187359,
        18.196034470562882, 21.83524136467546, 26.413598425010637,
        30.99195548534581, 35.335525004125344, 37.73035792799297
    ],
    "electricity_cost_annual": 292.0466802008797,
    "electricity_cost_monthly": [
        27.403969692311087, 24.651771361610617, 24.966875010963435,
        22.99997525664286, 22.297340663475694, 21.055934412562078,
        21.888810341168863, 22.980572409402637, 23.82407952750319,
        25.727586645603743, 26.500657501237605, 27.749107378397888
    ],
    "electricity_standing_charges_annual": 193.45000000000005,
    "electricity_standing_charges_monthly": [
        16.43, 14.84, 16.43, 15.9, 16.43, 15.9, 16.43, 16.43, 15.9, 16.43, 15.9,
        16.43
    ],
    "electricity_co2_equivalent_annual": 69.01767614061579,
    "electricity_co2_equivalent_monthly": [
        7.6817787846177605, 6.868239953127432, 5.975812507674406,
        4.969982679650001, 4.107138464432987, 3.6091540887934537,
        3.821167238818205, 4.585400686581846, 5.546855669252234,
        6.50831065192262, 7.420460250866322, 7.923375164878523
    ],
    "total_cost_annual": 1304.264405633967,
    "total_cost_monthly": [
        110.13955213462143, 157.97703126298214, 153.18581364864136,
        149.1721839453691, 106.06624422927322, 53.31325477750018,
        47.53275407450219, 49.87685779384708, 59.078069751406744,
        87.62212647202227, 138.80101667058412, 191.49950087321707
    ],
    "total_standing_charges_annual": 299.665,
    "total_standing_charges_monthly": [
        25.451, 22.988, 25.451, 24.63, 25.451, 24.63, 25.451, 25.451, 24.63,
        25.451, 24.63, 25.451
    ],
    "total_co2_equivalent_annual": 2334.0244897233338,
    "total_co2_equivalent_monthly": [
        191.9682348903936, 319.8113897065562, 303.9706591018692,
        298.5755044014656, 190.9768973789268, 62.4274550011387,
        45.37852657215154, 49.27361414769297, 71.85683122901115,
        138.69216021796893, 266.34635817423265, 394.74685890192654
    ]
}
{
    "title": "Energy Model Result",
    "description": "The result of an energy model calculation.",
    "type": "object",
    "properties": {
        "parameters": {
            "description": "The input parameters used in the energy model calculation.",
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "The location in which the property resides. Can be one of the following: A valid UK postcode or a UK region name."
                },
                "building_type": {
                    "type": "string",
                    "description": "The type of building to use. Can be one of the following: Detached, Semi-detached, Terraced, Tenement, 4-in-block, Tower/Slab, Flat, Conversion"
                },
                "construction_year": {
                    "type": "integer",
                    "description": "The year in which the building was constructed."
                },
                "building_age_band": {
                    "type": "string",
                    "description": "The age band of the building according to its construction year."
                },
                "total_floor_area": {
                    "type": "number",
                    "description": "Numerical value representing the total floor area of the property in m²."
                },
                "number_of_occupants": {
                    "type": "number",
                    "description": "Value representing the number of people that live/reside/work in the given property. If a value is not provided, an estimate is generated based on other information about the property"
                },
                "main_heating_efficiency": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the efficiency of the main heating system"
                },
                "water_heating_efficiency": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the efficiency of the water heating system."
                },
                "low_energy_lighting_proportion": {
                    "type": "number",
                    "description": "Float between 0 and 1 representing the fraction of lighting in the property that is low energy (50% energy consumption of “high” energy lighting)."
                },
                "primary_fuel": {
                    "type": "string",
                    "description": "The primary fuel type used to heat the building"
                },
                "building_characteristics": {
                    "type": "object",
                    "properties": {
                        "exposure_value": {
                            "type": "integer",
                            "description": "How exposed the property is to wind, etc. Approximately describes how many other objects (buildings, trees, etc) surround the property. 1-5"
                        },
                        "insulation_value": {
                            "type": "integer",
                            "description": "How well insulated the property is. Higher values indicate more insulation. 1-5"
                        },
                        "air_leakage_value": {
                            "type": "integer",
                            "description": "How much air and subsequently heat is lost from the property to the surrounding environment over time. Higher values indicate worse air tightness and higher air leakage. 1-5"
                        },
                        "capacity_value": {
                            "type": "integer",
                            "description": "Thermal mass of the property. Approximately describes how much internal volume there is in the property. Higher values indicate more volume / larger thermal mass. 1-2"
                        },
                        "solar_ingress_value": {
                            "type": "integer",
                            "description": "Amount of sunlight that enters the property through windows. Higher values indicate more sunlight entering the property. 1-3"
                        },
                        "occupancy_value": {
                            "type": "integer",
                            "description": "How many people live in the property. Higher values indicate more people. 1-5"
                        },
                        "living_area_value": {
                            "type": "integer",
                            "description": "How much of the internal space of the property is liveable (insulated, heated). 1-5"
                        }
                    }
                }
            }
        },
        "total_energy_usage": {
            "description": "The estimated annual total energy usage of the property",
            "type": "number"
        },
        "space_heating_annual": {
            "description": "The estimated annual space heating energy supply of the property",
            "type": "number"
        },
        "space_heating_monthly": {
            "description": "The estimated space heating energy supply of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "hot_water_annual": {
            "description": "The estimated annual hot water energy supply of the property",
            "type": "number"
        },
        "hot_water_monthly": {
            "description": "The estimated hot water energy supply of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "lighting_annual": {
            "description": "The estimated annual lighting energy demand of the property",
            "type": "number"
        },
        "lighting_monthly": {
            "description": "The estimated lighting energy demand of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "primary_fuel_price_per_kwh": {
            "description": "The price per kwh of the property's primary fuel",
            "type": "number"
        },
        "primary_fuel_co2_equivalent_per_kwh": {
            "description": "The CO2 emissions equivalent of the property's primary fuel, per kwh of energy used",
            "type": "number"
        },
        "primary_fuel_usage_annual": {
            "description": "The estimated annual primary fuel usage of the property",
            "type": "number"
        },
        "primary_fuel_usage_monthly": {
            "description": "The estimated primary fuel usage of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "primary_fuel_cost_annual": {
            "description": "The estimated annual primary fuel cost of the property",
            "type": "number"
        },
        "primary_fuel_cost_monthly": {
            "description": "The estimated primary fuel cost of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "primary_fuel_standing_charges_annual": {
            "description": "The estimated annual primary fuel standing charges of the property",
            "type": "number"
        },
        "primary_fuel_standing_charges_monthly": {
            "description": "The estimated primary fuel standing charges of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "primary_fuel_co2_equivalent_annual": {
            "description": "The estimated annual primary fuel CO2 emissions equivalent of the property",
            "type": "number"
        },
        "primary_fuel_co2_equivalent_monthly": {
            "description": "The estimated primary fuel CO2 emissions equivalent of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "electricity_price_per_kwh": {
            "description": "The price per kwh of electricity",
            "type": "number"
        },
        "electricity_co2_equivalent_per_kwh": {
            "description": "The estimated annual electricity CO2 emissions equivalent of the property",
            "type": "number"
        },
        "electricity_usage_annual": {
            "description": "The estimated annual electricity usage of the property",
            "type": "number"
        },
        "electricity_usage_monthly": {
            "description": "The estimated electicity usage of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "electricity_cost_annual": {
            "description": "The estimated annual electricity cost of the property",
            "type": "number"
        },
        "electricity_cost_monthly": {
            "description": "The estimated electicity cost of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "electricity_standing_charges_annual": {
            "description": "The estimated annual electricity standing charges of the property",
            "type": "number"
        },
        "electricity_standing_charges_monthly": {
            "description": "The estimated electicity standing charges of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "electricity_co2_equivalent_annual": {
            "description": "The estimated annual electricity CO2 emissions equivalent of the property",
            "type": "number"
        },
        "electricity_co2_equivalent_monthly": {
            "description": "The estimated electricity CO2 emissions equivalent of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "total_cost_annual": {
            "description": "The estimated annual total energy cost of the property (including standing charges)",
            "type": "number"
        },
        "total_cost_monthly": {
            "description": "The estimated total energy cost of the property by month (including standing charges)",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "total_standing_charges_annual": {
            "description": "The estimated annual total standing charges of the property",
            "type": "number"
        },
        "total_standing_charges_monthly": {
            "description": "The estimated total standing charges of the property by month",
            "type": "array",
            "items": {
                "type": "number"
            }
        },
        "total_co2_equivalent_annual": {
            "description": "The estimated annual CO2 emissions equivalent of the property",
            "type": "number"
        },
        "total_co2_equivalent_monthly": {
            "description": "The estimated total CO2 emissions equivalent of the property by month (including electricity usage)",
            "type": "array",
            "items": {
                "type": "number"
            }
        }
    }
}