syteDeveloper Platform
OverviewGuidesDataAPIContact
Get API Key

1. Renovation plan creation & energy demand

First guide in the syte Renovate series: Learn how to create your first renovation plan for a given address. This foundational guide covers energy demand simulation and introduces the core renovation planning endpoints.

Workflow Overview

Creating an energy simulation involves four main steps:

  • 1. Get Building Identifiers

    Fetch building and property IDs from coordinates

  • 2. Fetch Creation Inputs

    Get default parameters and existing measures

  • 3. Calculate Energy Demand

    Simulate current energy consumption

  • 4. Create Renovation Plan

    Generate baseline plan with available measures

Step 1: Get Building Identifiers

First, we need to obtain the building and property identifiers. We'll use the building-at endpoint to fetch data for our example address: Fernholzstraße 37, Münster.

Get Building Data
Required Fields from Response
FieldPathExample Value
Building IDproperties.identifierDENW49AL00009XAp
Property IDproperties.on_propertyPROPERTY-DENW49AL00009b0g

Step 2: Fetch Creation Inputs

The creation-inputs endpoint provides all the default parameters and existing measures needed to create a renovation plan. This includes building characteristics and current installations.

Get Creation Inputs
Response Structure

{ "property_identifier": "PROPERTY-DENW49AL00009b0g", "building_identifiers": ["DENW49AL00009XAp"], "name": "Fernholzstraße 37", "building_defaults": { "usable_area": 147.9977352, "rental_units": 1, "volume": 689.41345, "roof_type": "Schrägdach", "window_coverage": "small", "attic_conversion": "heated", "basement": "unheated", "construction_year": 1983 }, "existing_measures": { "heating_system": "gas", "roof_insulation": null, "wall_insulation": null, "basement_ceiling_insulation": null, "basement_wall_insulation": null, "foundation_slab_insulation": null, "windows": null, "roof_pv": null, "energy_storage": null } }

View complete schema documentation for creation inputs response →

Step 3: Calculate Energy Demand

Now we can simulate the building's current energy demand using the parameters from the previous step. This provides detailed energy metrics without creating a full renovation plan.

Calculate Energy Demand
Key Metrics in Response
MetricFieldExample Value
Energy Labelenergy_demand_labelH
Heating Demand (kWh/year)yearly_heating_demand_kwh_total33,642
CO₂ Emissions (kg/year)yearly_emissions_co2_kg_total9,330
Utility Costs (€/year)yearly_utility_costs_timeline[0]4,606
Example Response

{ "transmission_loss_factor": 2.002, "yearly_transmission_loss_kwh_by_sqm": 217.37, "yearly_transmission_loss_kwh_total": 32170.83, "yearly_heating_demand_kwh_by_sqm": 227.32, "yearly_heating_demand_kwh_total": 33642.31, "primary_energy_factor": 1.852, "yearly_primary_energy_demand_kwh_by_sqm": 288.95, "yearly_primary_energy_demand_kwh_total": 42764.47, "yearly_end_energy_demand_kwh_by_sqm": 262.69, "yearly_end_energy_demand_kwh_total": 38876.79, "yearly_emissions_co2_kg_by_sqm": 63.04, "yearly_emissions_co2_kg_total": 9330.43, "yearly_net_energy_hot_water_by_sqm": 9.10, "yearly_net_energy_hot_water_total": 1346.80, "energy_demand_label": "H", "kfw_efficiency_house": null, "yearly_utility_costs_timeline": [ 4605.91, 4777.52, 4906.11, 4982.91, 5061.35, // ... 16 more years of projections ], "energy_flow_graph": { "nodes": [ { "id": "household_electricity", "type": "consumption", "energy": 4100.0 }, { "id": "heating", "type": "consumption", "energy": 37380.35 }, // ... more nodes ], "edges": [ { "source": "grid_electricity_supply", "target": "direct_electricity_consumption", "energy": 4100.0 }, // ... more edges ] } }

View complete schema documentation for energy demand response →

Step 4: Create Renovation Plan

Finally, we create a complete renovation plan. This endpoint returns the building's current energy performance metrics along with all technically feasible renovation measures, including their costs and energy savings potential.

Create Renovation Plan
Key Fields in Response
FieldDescription
idUnique renovation plan identifier (UUID format). Use this ID to retrieve or update the plan later via the PUT endpoint at /api/renovate/{id}.
available_renovation_measuresObject containing all technically feasible renovation options organized by category (heating_system, roof_insulation, wall_insulation, windows, etc.). Each measure includes cost estimates, energy savings percentage, and technical metadata like U-values, power ratings, and areas.
output.existing_stateCurrent building energy performance including energy label (A+ to H), yearly heating demand in kWh, CO₂ emissions in kg, utility cost projections for 21 years, and a Sankey energy flow graph showing energy sources and consumption.
output.renovated_stateProjected building performance after applying planned renovation measures. Has the same structure as existing_state. When no measures are planned (as in this example), it will be identical to existing_state.
output.renovation_summarySummary of the renovation plan including total costs, available subsidies, yearly CO₂ emissions savings, and yearly energy savings. All values will be 0 when no measures are planned.
Example Response

{ "id": "f78d332e-a704-42ce-898c-98aed9883068", "property_identifier": "PROPERTY-DENW49AL00009b0g", "building_identifiers": ["DENW49AL00009XAp"], "available_renovation_measures": { "heating_system": [ { "type": "heat_pump_air_to_water", "cost": 44728, "end_energy_savings_percentage": 0.716, "metadata": { "power": 13.77, "yearly_cop": 3.15, "flow_temperature": 60.0 } }, // ... more heating options ], "roof_insulation": [ { "type": "kfw40", "cost": 97727, "end_energy_savings_percentage": 0.130, "metadata": { "uncovered_area": 169.66, "u_value": 0.1 } }, // ... more insulation standards ], // ... other measure categories }, "output": { "existing_state": { "energy_demand_label": "H", "yearly_heating_demand_kwh_total": 33642.31, "yearly_emissions_co2_kg_total": 9330.43, "yearly_utility_costs_timeline": [4605.91, 4777.52, ...], "energy_flow_graph": { "nodes": [...], "edges": [...] } }, "renovated_state": { // Same structure as existing_state // (identical when no measures are planned) }, "renovation_summary": { "costs_total": 0, "subsidies_total": 0, "yearly_emissions_savings_co2_kg_total": 0, "yearly_end_energy_savings_kwh_total": 0 } } }

View complete schema documentation for renovation response →

Next Steps

Now that you have a baseline renovation plan, you can:

  • Add Renovation Measures

    Update the plan with specific measures to see their impact

  • Store and Update

    Use the plan ID to retrieve and modify the renovation plan

  • Compare Scenarios

    Create multiple plans to compare different renovation strategies

Pro tip: Save the renovation plan ID (id) to update it later with the PUT endpoint at /api/renovate/{id}.

Additional Resources