Rechenwerk
housing allowance
Determines the rent level (Mietenstufe) from the WoGV annex (municipalities with 10 000+ inhabitants individually, otherwise the district; Gebietsstand 31.03.2021, valid since 2023) or takes it from the caller. Rent M = min(gross cold rent, maximum amount of Anlage 1 + climate component § 12(7)) + heating relief § 12(6); income Y = sum over members of (positive income, employment income minus at least the 1 230 EUR lump sum) minus 10 % each for income tax, health/care and pension.
POST https://rechen.halowerk.com/v1/housing-allowanceInputs
| Field | Type | Required | Description |
|---|---|---|---|
| month | string | Yes | Month of the claim (YYYY-MM); 2025-01 to 2026-12. |
| household_size | integer | Yes | Number of household members to be considered (§ 6 WoGG). |
| rent_level | string | No | Mietenstufe, if known. Otherwise give state and municipality. |
| state | string | No | Federal state of the flat (for the rent-level lookup). |
| municipality | string | No | Municipality name as in the WoGV list, e.g. "Münster, Stadt" or "Münster". |
| district | string | No | District (Kreis) for municipalities with fewer than 10 000 inhabitants. |
| monthly_rent | number | Yes | Monthly gross cold rent (rent incl. cold service charges, without heating, hot water and household energy, § 9 WoGG) in EUR. |
| members_income | array | Yes | Expected annual income per household member with income. |
| severely_disabled_members | integer | No | Members with GdB 100 or GdB < 100 with home care (§ 17 no. 1: 1 800 EUR each). |
| persecution_victims | integer | No | Members recognised as victims of Nazi persecution (§ 17 no. 2: 750 EUR each). |
| single_parent_allowance | boolean | No | § 17 no. 3: a member lives only with children, at least one under 18 with Kindergeld (1 320 EUR). |
| children_earned_income | array | No | |
| maintenance_deduction_annual | number | No | Deductible maintenance payments per year within the limits of § 18 WoGG. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"month",
"household_size",
"monthly_rent",
"members_income"
],
"properties": {
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "Month of the claim (YYYY-MM); 2025-01 to 2026-12."
},
"household_size": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Number of household members to be considered (§ 6 WoGG)."
},
"rent_level": {
"type": "string",
"enum": [
"I",
"II",
"III",
"IV",
"V",
"VI",
"VII"
],
"description": "Mietenstufe, if known. Otherwise give state and municipality."
},
"state": {
"type": "string",
"enum": [
"BW",
"BY",
"BE",
"BB",
"HB",
"HH",
"HE",
"MV",
"NI",
"NW",
"RP",
"SL",
"SN",
"ST",
"SH",
"TH"
],
"description": "Federal state of the flat (for the rent-level lookup)."
},
"municipality": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Municipality name as in the WoGV list, e.g. \"Münster, Stadt\" or \"Münster\"."
},
"district": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "District (Kreis) for municipalities with fewer than 10 000 inhabitants."
},
"monthly_rent": {
"type": "number",
"minimum": 0,
"maximum": 20000,
"description": "Monthly gross cold rent (rent incl. cold service charges, without heating, hot water and household energy, § 9 WoGG) in EUR."
},
"members_income": {
"type": "array",
"minItems": 1,
"maxItems": 30,
"description": "Expected annual income per household member with income.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"employment_gross_annual": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Gross wages per year in EUR (reduced by the employee lump sum 1 230 EUR or higher work expenses)."
},
"work_expenses_annual": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Actual work expenses if higher than 1 230 EUR."
},
"other_income_annual": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Other positive income and § 14(2) WoGG receipts per year (e.g. taxable pension share plus tax-free part, maintenance received, unemployment benefit)."
},
"pays_income_tax": {
"type": "boolean",
"default": false,
"description": "Income tax is expected to be paid (§ 16 no. 1)."
},
"pays_health_care": {
"type": "boolean",
"default": false,
"description": "Compulsory (or equivalent) health and care insurance contributions (§ 16 no. 2)."
},
"pays_pension": {
"type": "boolean",
"default": false,
"description": "Compulsory (or equivalent) pension contributions (§ 16 no. 3)."
}
}
}
},
"severely_disabled_members": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"default": 0,
"description": "Members with GdB 100 or GdB < 100 with home care (§ 17 no. 1: 1 800 EUR each)."
},
"persecution_victims": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"default": 0,
"description": "Members recognised as victims of Nazi persecution (§ 17 no. 2: 750 EUR each)."
},
"single_parent_allowance": {
"type": "boolean",
"default": false,
"description": "§ 17 no. 3: a member lives only with children, at least one under 18 with Kindergeld (1 320 EUR)."
},
"children_earned_income": {
"type": "array",
"maxItems": 20,
"items": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Own earned income per year of a child under 25 (allowance up to 1 200 EUR each, § 17 no. 4)."
}
},
"maintenance_deduction_annual": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"description": "Deductible maintenance payments per year within the limits of § 18 WoGG."
}
}
}Published input example
{
"month": "2026-11",
"household_size": 1,
"state": "BW",
"municipality": "Aalen",
"monthly_rent": 500,
"members_income": [
{
"employment_gross_annual": 16000,
"pays_income_tax": true,
"pays_health_care": true,
"pays_pension": true
}
]
}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