Skip to content
HALOWERK

Rechenwerk

heating cost split

For combined systems the hot water share of the total costs is determined from the fuel or energy share (§ 9(1) HeizkostenV): given directly, from a heat meter, from the formula Q = 2.5 × V × (tw − 10) kWh (§ 9(2) sentence 2, × 1.11 for gross-calorific gas billing, ÷ 1.15 for heat delivery, × 0.30 for monovalent heat pumps) or Q = 32 × living area, converted to fuel by B = Q / Hi with the supplier heating value or the auxiliary values of § 9(3) (e.g. heating oil 10 kWh/l, natural gas H 10.

POST https://rechen.halowerk.com/v1/heating-cost-split

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
total_costsnumberYesTotal costs of the central heating (and hot water) system for the period in EUR (§ 7(2), § 8(2)).
hot_waterobjectNoHot water part of a combined system; omit for heating only.
heating_consumption_percentnumberNoShare of heating costs allocated by recorded consumption (§ 7(1)).
mandatory_70_percentbooleanNoBuilding below the 1994 thermal insulation ordinance, oil or gas heating, mostly insulated pipes (§ 7(1) sentence 2).
no_remote_readingbooleanNoNo remote-readable metering although required, or missing consumption information (§ 12(1) sentences 2-3: 3 % reduction).
unitsarrayYesUnits with area and recorded consumption.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "total_costs",
    "units"
  ],
  "properties": {
    "total_costs": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000000,
      "description": "Total costs of the central heating (and hot water) system for the period in EUR (§ 7(2), § 8(2))."
    },
    "hot_water": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "method"
      ],
      "description": "Hot water part of a combined system; omit for heating only.",
      "properties": {
        "method": {
          "type": "string",
          "enum": [
            "cost_given",
            "heat_meter",
            "volume_formula",
            "area_formula"
          ],
          "description": "cost_given = hot water costs known; heat_meter = measured kWh; volume_formula = § 9(2) sentence 2; area_formula = § 9(2) sentence 4."
        },
        "cost": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000,
          "description": "cost_given: hot water costs in EUR."
        },
        "heat_kwh": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000,
          "description": "heat_meter: measured heat for hot water in kWh."
        },
        "volume_m3": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000000,
          "description": "volume_formula: measured hot water volume V in m³."
        },
        "temperature_c": {
          "type": "number",
          "minimum": 10.1,
          "maximum": 100,
          "description": "volume_formula: mean hot water temperature tw in °C."
        },
        "area_m2": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000000,
          "description": "area_formula: living area supplied with hot water."
        },
        "energy_adjustment": {
          "type": "string",
          "enum": [
            "none",
            "gas_gross_calorific",
            "heat_delivery",
            "heat_pump"
          ],
          "default": "none",
          "description": "Factor of § 9(2) sentence 5: × 1.11, ÷ 1.15 or × 0.30."
        },
        "fuel": {
          "type": "string",
          "enum": [
            "heating_oil_el",
            "heating_oil_heavy",
            "natural_gas_h",
            "natural_gas_l",
            "lpg",
            "coke",
            "lignite",
            "hard_coal",
            "firewood",
            "energy_kwh"
          ],
          "default": "energy_kwh",
          "description": "Unit of the total consumption: a fuel with auxiliary heating value (§ 9(3)) or energy in kWh."
        },
        "heating_value": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 100,
          "description": "Heating value Hi from the supplier invoice (kWh per unit), overrides the auxiliary value."
        },
        "total_consumption": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000000000,
          "description": "Total fuel (litres, m³, kg) or energy (kWh) of the period for heating and hot water."
        },
        "consumption_percent": {
          "type": "number",
          "minimum": 50,
          "maximum": 70,
          "default": 70,
          "description": "Share of hot water costs allocated by consumption (§ 8(1))."
        }
      }
    },
    "heating_consumption_percent": {
      "type": "number",
      "minimum": 50,
      "maximum": 70,
      "default": 70,
      "description": "Share of heating costs allocated by recorded consumption (§ 7(1))."
    },
    "mandatory_70_percent": {
      "type": "boolean",
      "default": false,
      "description": "Building below the 1994 thermal insulation ordinance, oil or gas heating, mostly insulated pipes (§ 7(1) sentence 2)."
    },
    "no_remote_reading": {
      "type": "boolean",
      "default": false,
      "description": "No remote-readable metering although required, or missing consumption information (§ 12(1) sentences 2-3: 3 % reduction)."
    },
    "units": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "description": "Units with area and recorded consumption.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "area_m2",
          "heat_units"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Unit reference."
          },
          "area_m2": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000000,
            "description": "Living or usable area."
          },
          "heat_units": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "Recorded heat consumption (meter or allocator units)."
          },
          "hot_water_m3": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Recorded hot water consumption in m³."
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "total_costs": 10000,
  "units": [
    {
      "id": "A",
      "area_m2": 60,
      "heat_units": 300
    },
    {
      "id": "B",
      "area_m2": 40,
      "heat_units": 100
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →