Skip to content
HALOWERK

Rechenwerk

service charges check

Classifies each cost item by the given BetrKV category or by German keywords of the 17 categories of § 2 BetrKV (property tax, water, drainage, heating, hot water, lift, street cleaning and waste, cleaning, garden, lighting, chimney, insurance, caretaker, aerial/broadband/fibre, laundry, other) and flags non-allocable items: administration and maintenance or repair (§ 1(2) BetrKV), reserves, bank fees. Communal aerial and broadband fees are allocable only until 30 Jun 2024 apart from.

POST https://rechen.halowerk.com/v1/service-charges-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
itemsarrayYesCost items of the building for the billing period.
agreed_categoriesarrayNoBetrKV numbers agreed in the tenancy contract as allocable (omit if not checked).
total_area_m2numberYesTotal living area of the building.
tenant_area_m2numberYesLiving area of the flat.
prepaymentsnumberNoTenant prepayments made for the period.
period_startstringNoStart of the billing period.
period_endstringNoEnd of the billing period.
statement_receivedstringNoDate the tenant received the statement.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "items",
    "total_area_m2",
    "tenant_area_m2"
  ],
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "description": "Cost items of the building for the billing period.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "label",
          "amount"
        ],
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Item name as in the statement (German keywords are recognised)."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "Total cost of the building for this item in EUR."
          },
          "category": {
            "oneOf": [
              {
                "type": "integer",
                "minimum": 1,
                "maximum": 17
              },
              {
                "type": "string",
                "enum": [
                  "administration",
                  "maintenance_repair",
                  "reserve",
                  "bank_fees",
                  "vacancy_loss"
                ]
              }
            ],
            "description": "BetrKV § 2 number 1-17 or an excluded type; overrides the keyword detection."
          },
          "installation_from_2021_12": {
            "type": "boolean",
            "default": false,
            "description": "Category 15: aerial or broadband installation built from 1 Dec 2021."
          },
          "operating_current_only": {
            "type": "boolean",
            "default": false,
            "description": "Category 15: the amount covers only operating current and checks."
          }
        }
      }
    },
    "agreed_categories": {
      "type": "array",
      "maxItems": 17,
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 17
      },
      "description": "BetrKV numbers agreed in the tenancy contract as allocable (omit if not checked)."
    },
    "total_area_m2": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000,
      "description": "Total living area of the building."
    },
    "tenant_area_m2": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000,
      "description": "Living area of the flat."
    },
    "prepayments": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Tenant prepayments made for the period."
    },
    "period_start": {
      "type": "string",
      "format": "date",
      "description": "Start of the billing period."
    },
    "period_end": {
      "type": "string",
      "format": "date",
      "description": "End of the billing period."
    },
    "statement_received": {
      "type": "string",
      "format": "date",
      "description": "Date the tenant received the statement."
    }
  }
}

Open original schema

Published input example

{
  "items": [
    {
      "label": "Grundsteuer",
      "amount": 600
    },
    {
      "label": "Wasser",
      "amount": 900
    },
    {
      "label": "Hausverwaltung",
      "amount": 400
    }
  ],
  "total_area_m2": 400,
  "tenant_area_m2": 80,
  "prepayments": 360
}

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 →