Skip to content
HALOWERK

Rechenwerk

co2 cost split

Residential buildings: specific emissions = kg CO2 of the billing period / living area, rounded to one decimal (§ 5(1) CO2KostAufG), classified in the table of the Anlage (BGBl. I 2022, 2159; unchanged by the amendment of 23 Jul 2026): below 12 kg the tenant bears 100 %, then landlord 10, 20, 30, 40, 50, 60, 70, 80 % per 5 kg step and 95 % from 52 kg; thresholds scaled for billing periods shorter than a year (§ 5(1) sentence 4). Non-residential buildings: landlord 50 % (§ 8). Public-law.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
building_typestringYesresidential = mainly residential building (§ 5); non_residential = § 8.
co2_emissions_kgnumberYesCO2 emissions of the heating fuel or heat supply for the billing period in kg (from the supplier invoices, § 3(1) no. 1).
area_m2numberYesLiving area of the building (or of the separately supplied flat) in m².
co2_cost_eurnumberNoCO2 cost component of the invoices in EUR incl. VAT; if omitted it is computed from the certificate price.
delivery_yearintegerNoYear of the fuel delivery for the certificate price (required if co2_cost_eur is omitted).
vat_percentnumberNoVAT rate applied to the computed CO2 cost.
billing_period_daysintegerNoLength of the billing period; below one year the step thresholds are reduced proportionally.
restrictionsstringNoPublic-law restrictions (listed building, mandatory district heating, preservation statute) against a substantial energy improvement of the building or of the heat supply (§ 9).
tenant_cost_share_percentnumberNoShare of the building heating costs billed to one tenant, to compute that tenant amount.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "building_type",
    "co2_emissions_kg",
    "area_m2"
  ],
  "properties": {
    "building_type": {
      "type": "string",
      "enum": [
        "residential",
        "non_residential"
      ],
      "description": "residential = mainly residential building (§ 5); non_residential = § 8."
    },
    "co2_emissions_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000000,
      "description": "CO2 emissions of the heating fuel or heat supply for the billing period in kg (from the supplier invoices, § 3(1) no. 1)."
    },
    "area_m2": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000,
      "description": "Living area of the building (or of the separately supplied flat) in m²."
    },
    "co2_cost_eur": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "CO2 cost component of the invoices in EUR incl. VAT; if omitted it is computed from the certificate price."
    },
    "delivery_year": {
      "type": "integer",
      "minimum": 2023,
      "maximum": 2026,
      "description": "Year of the fuel delivery for the certificate price (required if co2_cost_eur is omitted)."
    },
    "vat_percent": {
      "type": "number",
      "minimum": 0,
      "maximum": 25,
      "default": 19,
      "description": "VAT rate applied to the computed CO2 cost."
    },
    "billing_period_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 366,
      "default": 365,
      "description": "Length of the billing period; below one year the step thresholds are reduced proportionally."
    },
    "restrictions": {
      "type": "string",
      "enum": [
        "none",
        "building_or_supply",
        "both"
      ],
      "default": "none",
      "description": "Public-law restrictions (listed building, mandatory district heating, preservation statute) against a substantial energy improvement of the building or of the heat supply (§ 9)."
    },
    "tenant_cost_share_percent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Share of the building heating costs billed to one tenant, to compute that tenant amount."
    }
  }
}

Open original schema

Published input example

{
  "building_type": "residential",
  "co2_emissions_kg": 30000,
  "area_m2": 1000,
  "co2_cost_eur": 1620
}

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 →