Skip to content
HALOWERK

Rechenwerk

child benefit test

For each child, oldest first (per-child comparison, H 31 EStH), the tax relief from the child allowance and the care/education allowance (§ 32 Abs. 6 EStG; 2024: 3 306 + 1 464, 2025: 3 336 + 1 464, 2026: 3 414 + 1 464 EUR per parent, doubled for joint assessment, reduced by 1/12 per month without entitlement) is compared with the Kindergeld entitlement for the year (250/255/259 EUR per month; half for separately assessed parents, § 31 sentence 4). If the relief is higher, the allowances are.

POST https://rechen.halowerk.com/v1/child-benefit-test

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
tax_yearintegerYesAssessment year (2024, 2025 or 2026 are supported).
taxable_income_before_child_allowancesnumberYesTaxable income (zu versteuerndes Einkommen) before deducting allowances for children, in EUR; for joint assessment the joint amount.
assessmentstringNojoint = spouses assessed jointly (splitting, full allowances); individual = single assessment (basic tariff, half allowances unless full_allowances).
childrenarrayYesChildren in order of age (oldest first).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "tax_year",
    "taxable_income_before_child_allowances",
    "children"
  ],
  "properties": {
    "tax_year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Assessment year (2024, 2025 or 2026 are supported)."
    },
    "taxable_income_before_child_allowances": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Taxable income (zu versteuerndes Einkommen) before deducting allowances for children, in EUR; for joint assessment the joint amount."
    },
    "assessment": {
      "type": "string",
      "enum": [
        "joint",
        "individual"
      ],
      "default": "joint",
      "description": "joint = spouses assessed jointly (splitting, full allowances); individual = single assessment (basic tariff, half allowances unless full_allowances)."
    },
    "children": {
      "type": "array",
      "minItems": 1,
      "maxItems": 15,
      "description": "Children in order of age (oldest first).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "months": {
            "type": "integer",
            "minimum": 1,
            "maximum": 12,
            "default": 12,
            "description": "Months of the year with entitlement (child considered under § 32 EStG)."
          },
          "full_allowances": {
            "type": "boolean",
            "default": false,
            "description": "Individual assessment only: full allowances and full Kindergeld (other parent deceased, abroad or allowance transferred, § 32(6) sentences 3 and 6)."
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "tax_year": 2026,
  "taxable_income_before_child_allowances": 150000,
  "assessment": "joint",
  "children": [
    {
      "months": 12
    }
  ]
}

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 →