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-checkInputs
| Field | Type | Required | Description |
|---|---|---|---|
| items | array | Yes | Cost items of the building for the billing period. |
| agreed_categories | array | No | BetrKV numbers agreed in the tenancy contract as allocable (omit if not checked). |
| total_area_m2 | number | Yes | Total living area of the building. |
| tenant_area_m2 | number | Yes | Living area of the flat. |
| prepayments | number | No | Tenant prepayments made for the period. |
| period_start | string | No | Start of the billing period. |
| period_end | string | No | End of the billing period. |
| statement_received | string | No | Date 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."
}
}
}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
- Rechenwerk0.003 USDC
ai act risk class
POSThttps://rechen.halowerk.com/v1/ai-act-risk-classEvaluates the caller’s description against Regulation (EU) 2024/1689 as amended by Regulation (EU) 2026/1744: prohibited practices of Art. 5(1)(a)-(h) and the new points (ba) and (bb) (from 2 December 2026); high-risk under Art. 6(1) (safet
- Rechenwerk0.002 USDC
annuity schedule
POSThttps://rechen.halowerk.com/v1/annuity-scheduleMonthly annuity in arrears as used by German banks: rate = loan × (nominal rate + initial repayment rate) / 12, or from a term via A = L·q^n·(q−1)/(q^n−1) with q = 1 + i/12; interest each month = balance × i/12 (30/360), rounded to cents, t
- Rechenwerk0.002 USDC
appeal deadlines
POSThttps://rechen.halowerk.com/v1/appeal-deadlinesCovers only clearly codified periods: Berufung one month and grounds two months (§§ 517, 520(2) ZPO), Revision one and two months (§§ 548, 551(2) ZPO), labour court appeal (§ 66(1) ArbGG), all starting with service of the complete judgment