Skip to content

Usage and Examples

Minimal request

Request

{
    "iframeId": "string",
    "countryIndex": "DE",
    "projectName": "Name of project",
    "projectType": "renovatingHouse",
    "fullAddress": "Bremen",
    "coordinates": {
        "lat": 53.0793,
        "lng": 8.8017
    },
    "buildingStatus": {
        "heatedLivingArea": 110,
        "houseType": "singleFamilyHouse",
        "energyStandard": "before1960",
        "isSolarHeatingSystem": false,
        "isSolarPowerSystem": false,
        "solarPowerSystemSize": 15,
        "batteryStorageSize": 15,
        "solarHeatingSystemType": "onlyHotWater",
        "heatingSystem": "heatingOil",
        "hotWaterProducer": "heatingSystem",
        "heatingSystemAge": "olderThan20Years",
        "roomTemperature": "lessThan21",
        "hotWaterAmount": "low",
        "residentsCount": 4,
        "renovations": ["newWindows"],
        "powerConsumers": [],
        "devicesAreYoungerThan10Years": true
    },
    "renovatingFormValues": {
        "systemCalculatedValues": true,
        "floorsNumber": 2,
        "features": ["heatingSystem", "newWindows", "facadeInsulation", "solarPowerSystem", "batteryStorage"],
        "facadeInsulationArea": 190,
        "facadeInsulationEquipmentType": "standard",
        "facadeInsulationType": "single",
        "newWindowsNumber": 8,
        "extraLargeWindowsNumber": 0,
        "liftAndSlideDoorsNumber": 0,
        "newWindowsEquipmentType": "standard",
        "roofArea": 0,
        "roofEquipmentType": "standard",
        "roofType": "flat",
        "ceilingTopInsulationArea": 0,
        "ceilingBasementInsulationArea": 0,
        "heatingSystemForRenovation": "heatPump",
        "heatingSystemEquipmentType": "standard",
        "newSolarPowerSystemSize": 5,
        "solarPowerSystemEquipmentType": "standard",
        "batteryStorageBlackoutOption": false,
        "batteryStorageSize": 7,
        "frontDoorEquipmentType": "standard",
        "domesticVentilationEquipmentType": "standard",
        "hotWaterWithNewHeatingSystem": false
    }
}

Response

{
    "co2Calculation": {
        "actualBuildingStatus": {
            "calculation": {
                "specificHeatingDemand": 0,
                "heatingFactorKea": 0,
                "heatingFactorGhg": 0,
                "totalHeatingDemand": 0,
                "primaryEnergyForHotWaterTemp": 0,
                "primaryEnergyForHeatingTemp": 0,
                "heatingGhgEmission": 0,
                "hotWaterGhgEmission": 0,
                "heatingGhgEquivalentCar": 0,
                "hotWaterGhgEquivalentCar": 0,
                "electricityGhgEquivalentCar": 0,
                "energyGhgEquivalentCar": 0,
                "heatingGhgEquivalentPlane": 0,
                "hotWaterGhgEquivalentPlane": 0,
                "electricityGhgEquivalentPlane": 0,
                "energyGhgEquivalentPlane": 0,
                "heatingGhgEquivalentTrees": 0,
                "hotWaterGhgEquivalentTrees": 0,
                "electricityGhgEquivalentTrees": 0,
                "energyGhgEquivalentTrees": 0,
                "totalHeatingCosts": 0,
                "totalHotWaterCosts": 0,
                "totalElectricityCosts": 0,
                "totalEnergyCosts": {
                    "calculatedValue": 0
                },
                "totalEnergyBalancePerYear": {
                    "calculatedValue": 0
                },
                "energyGhgBalancePerYear": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHeating": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHotWater": {
                    "calculatedValue": 0
                },
                "totalPowerConsumptionPerYear": {
                    "calculatedValue": 0
                },
                "totalPowerProductionPerYear": 0,
                "ownConsumption": 0,
                "ownConsumptionType": "currentOwnConsumption",
                "powerConsumptionFromEnergyCosts": 0,
                "powerConsumptionFromEnergy": 0,
                "electricalFeedIntoGrid": 0,
                "electricalFeedIntoGridCosts": 0,
                "ghgSavingsSolarPowerSystem": 0,
                "ghgBalanceOfPowerConsumption": 0,
                "solarPowerSystemHelpsToSave": 0,
                "specificHeatingDemandPerSqm": 0,
                "hwbCategory": "A++",
                "primaryEnergyPerSqm": 0,
                "pebCategory": "A++",
                "ghgPerSqm": 0,
                "ghgCategory": "A++",
                "efficiencyFactor": 0,
                "efficiencyFactorCat": "A++"
            },
            "formValues": {
                "heatedLivingArea": 110,
                "houseType": "singleFamilyHouse",
                "energyStandard": "before1960",
                "isSolarHeatingSystem": false,
                "isSolarPowerSystem": false,
                "solarPowerSystemSize": 15,
                "batteryStorageSize": 15,
                "solarHeatingSystemType": "onlyHotWater",
                "heatingSystem": "heatingOil",
                "hotWaterProducer": "heatingSystem",
                "heatingSystemAge": "olderThan20Years",
                "roomTemperature": "lessThan21",
                "hotWaterAmount": "low",
                "residentsCount": 4,
                "renovations": ["newWindows"],
                "powerConsumers": [],
                "devicesAreYoungerThan10Years": true
            }
        },
        "possibleBuildingStatus": {
            "calculation": {
                "specificHeatingDemand": 0,
                "heatingFactorKea": 0,
                "heatingFactorGhg": 0,
                "totalHeatingDemand": 0,
                "primaryEnergyForHotWaterTemp": 0,
                "primaryEnergyForHeatingTemp": 0,
                "heatingGhgEmission": 0,
                "hotWaterGhgEmission": 0,
                "heatingGhgEquivalentCar": 0,
                "hotWaterGhgEquivalentCar": 0,
                "electricityGhgEquivalentCar": 0,
                "energyGhgEquivalentCar": 0,
                "heatingGhgEquivalentPlane": 0,
                "hotWaterGhgEquivalentPlane": 0,
                "electricityGhgEquivalentPlane": 0,
                "energyGhgEquivalentPlane": 0,
                "heatingGhgEquivalentTrees": 0,
                "hotWaterGhgEquivalentTrees": 0,
                "electricityGhgEquivalentTrees": 0,
                "energyGhgEquivalentTrees": 0,
                "totalHeatingCosts": 0,
                "totalHotWaterCosts": 0,
                "totalElectricityCosts": 0,
                "totalEnergyCosts": {
                    "calculatedValue": 0
                },
                "totalEnergyBalancePerYear": {
                    "calculatedValue": 0
                },
                "energyGhgBalancePerYear": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHeating": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHotWater": {
                    "calculatedValue": 0
                },
                "totalPowerConsumptionPerYear": {
                    "calculatedValue": 0
                },
                "totalPowerProductionPerYear": 0,
                "ownConsumption": 0,
                "ownConsumptionType": "currentOwnConsumption",
                "powerConsumptionFromEnergyCosts": 0,
                "powerConsumptionFromEnergy": 0,
                "electricalFeedIntoGrid": 0,
                "electricalFeedIntoGridCosts": 0,
                "ghgSavingsSolarPowerSystem": 0,
                "ghgBalanceOfPowerConsumption": 0,
                "solarPowerSystemHelpsToSave": 0,
                "specificHeatingDemandPerSqm": 0,
                "hwbCategory": "A++",
                "primaryEnergyPerSqm": 0,
                "pebCategory": "A++",
                "ghgPerSqm": 0,
                "ghgCategory": "A++",
                "efficiencyFactor": 0,
                "efficiencyFactorCat": "A++"
            },
            "formValues": {
                "heatedLivingArea": 110,
                "houseType": "singleFamilyHouse",
                "energyStandard": "before1960",
                "isSolarHeatingSystem": false,
                "isSolarPowerSystem": false,
                "solarPowerSystemSize": 15,
                "batteryStorageSize": 15,
                "solarHeatingSystemType": "onlyHotWater",
                "heatingSystem": "heatingOil",
                "hotWaterProducer": "heatingSystem",
                "heatingSystemAge": "olderThan20Years",
                "roomTemperature": "lessThan21",
                "hotWaterAmount": "low",
                "residentsCount": 4,
                "renovations": ["newWindows"],
                "powerConsumers": [],
                "devicesAreYoungerThan10Years": true
            }
        },
        "plannedBuildingStatus": {
            "calculation": {
                "specificHeatingDemand": 0,
                "heatingFactorKea": 0,
                "heatingFactorGhg": 0,
                "totalHeatingDemand": 0,
                "primaryEnergyForHotWaterTemp": 0,
                "primaryEnergyForHeatingTemp": 0,
                "heatingGhgEmission": 0,
                "hotWaterGhgEmission": 0,
                "heatingGhgEquivalentCar": 0,
                "hotWaterGhgEquivalentCar": 0,
                "electricityGhgEquivalentCar": 0,
                "energyGhgEquivalentCar": 0,
                "heatingGhgEquivalentPlane": 0,
                "hotWaterGhgEquivalentPlane": 0,
                "electricityGhgEquivalentPlane": 0,
                "energyGhgEquivalentPlane": 0,
                "heatingGhgEquivalentTrees": 0,
                "hotWaterGhgEquivalentTrees": 0,
                "electricityGhgEquivalentTrees": 0,
                "energyGhgEquivalentTrees": 0,
                "totalHeatingCosts": 0,
                "totalHotWaterCosts": 0,
                "totalElectricityCosts": 0,
                "totalEnergyCosts": {
                    "calculatedValue": 0
                },
                "totalEnergyBalancePerYear": {
                    "calculatedValue": 0
                },
                "energyGhgBalancePerYear": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHeating": {
                    "calculatedValue": 0
                },
                "primaryEnergyForHotWater": {
                    "calculatedValue": 0
                },
                "totalPowerConsumptionPerYear": {
                    "calculatedValue": 0
                },
                "totalPowerProductionPerYear": 0,
                "ownConsumption": 0,
                "ownConsumptionType": "currentOwnConsumption",
                "powerConsumptionFromEnergyCosts": 0,
                "powerConsumptionFromEnergy": 0,
                "electricalFeedIntoGrid": 0,
                "electricalFeedIntoGridCosts": 0,
                "ghgSavingsSolarPowerSystem": 0,
                "ghgBalanceOfPowerConsumption": 0,
                "solarPowerSystemHelpsToSave": 0,
                "specificHeatingDemandPerSqm": 0,
                "hwbCategory": "A++",
                "primaryEnergyPerSqm": 0,
                "pebCategory": "A++",
                "ghgPerSqm": 0,
                "ghgCategory": "A++",
                "efficiencyFactor": 0,
                "efficiencyFactorCat": "A++"
            },
            "formValues": {
                "heatedLivingArea": 110,
                "houseType": "singleFamilyHouse",
                "energyStandard": "before1960",
                "isSolarHeatingSystem": false,
                "isSolarPowerSystem": false,
                "solarPowerSystemSize": 15,
                "batteryStorageSize": 15,
                "solarHeatingSystemType": "onlyHotWater",
                "heatingSystem": "heatingOil",
                "hotWaterProducer": "heatingSystem",
                "heatingSystemAge": "olderThan20Years",
                "roomTemperature": "lessThan21",
                "hotWaterAmount": "low",
                "residentsCount": 4,
                "renovations": ["newWindows"],
                "powerConsumers": [],
                "devicesAreYoungerThan10Years": true
            }
        }
    },
    "project": {
        "name": "string",
        "type": "renovatingHouse",
        "formValues": {
            "fullAddress": "string",
            "coordinates": {
                "lat": 0,
                "lng": 0
            },
            "houseArea": 0
        },
        "country": "DE",
        "countryIndex": 0,
        "price": 0,
        "equipmentType": "standard",
        "features": {
            "enabled": ["heatingSystem"],
            "disabled": ["heatingSystem"]
        },
        "meta": {
            "clientIP": "string",
            "domain": "string"
        },
        "tenantId": "string",
        "iframeId": "string",
        "createdAt": "2024-01-10T07:53:59.621Z",
        "updatedAt": "2024-01-10T07:53:59.621Z",
        "buildingPrice": 0
    },
    "projectPlan": {
        "projectId": "string",
        "price": 0,
        "categories": {
            "heatingSystem": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "heatingSystem": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "facadeInsulation": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "facadeInsulation": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "newWindows": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "newWindows": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "roof": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "roof": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "ceilingTopInsulation": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "ceilingTopInsulation": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "ceilingBasementInsulation": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "ceilingBasementInsulation": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "solarPowerSystem": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "solarPowerSystem": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "solarHeating": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "solarHeating": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "domesticVentilation": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "domesticVentilation": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "frontDoor": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "frontDoor": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "wallboxEMobility": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "wallboxEMobility": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            },
            "batteryStorage": {
                "calculatedPrice": 0,
                "avgEquipmentType": "string",
                "hasMixedEquipmentType": true,
                "planningItems": {
                    "batteryStorage": {
                        "calculatedPrice": 0,
                        "hasEquipmentTypes": true,
                        "equipmentType": "standard"
                    }
                }
            }
        }
    }
}