Skip to content
HALOWERK

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-allowance

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
monthstringYesMonth of the claim (YYYY-MM); 2025-01 to 2026-12.
household_sizeintegerYesNumber of household members to be considered (§ 6 WoGG).
rent_levelstringNoMietenstufe, if known. Otherwise give state and municipality.
statestringNoFederal state of the flat (for the rent-level lookup).
municipalitystringNoMunicipality name as in the WoGV list, e.g. "Münster, Stadt" or "Münster".
districtstringNoDistrict (Kreis) for municipalities with fewer than 10 000 inhabitants.
monthly_rentnumberYesMonthly gross cold rent (rent incl. cold service charges, without heating, hot water and household energy, § 9 WoGG) in EUR.
members_incomearrayYesExpected annual income per household member with income.
severely_disabled_membersintegerNoMembers with GdB 100 or GdB < 100 with home care (§ 17 no. 1: 1 800 EUR each).
persecution_victimsintegerNoMembers recognised as victims of Nazi persecution (§ 17 no. 2: 750 EUR each).
single_parent_allowancebooleanNo§ 17 no. 3: a member lives only with children, at least one under 18 with Kindergeld (1 320 EUR).
children_earned_incomearrayNo
maintenance_deduction_annualnumberNoDeductible 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →