Skip to content
HALOWERK

Rechenwerk

notice date latest

Works backwards from the desired end: checks whether the date is an admissible termination date for the regime (15th or month end, month end, quarter end, any day) and searches the latest receipt day whose earliest possible end is not after it. Regimes: § 622(1) and (2) BGB with service length measured at receipt, probation § 622(3), residential tenancy § 573c(1) with third-working-day rule (Saturday counts except as last day, BGH VIII ZR 206/04) and landlord extensions after 5/8 years,.

POST https://rechen.halowerk.com/v1/notice-date-latest

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
regimestringYesemployment_basic = § 622(1) (employee, or employer under two years); employment_employer = § 622(2) by service length; employment_probation = § 622(3); residential_* = § 573c(1); furnished_room = § 573c(3); commercial_premises = § 580a(2); custom = contractual period.
desired_endstringYesDesired last day of the contract.
employment_startstringNoRequired for employment_employer.
handover_datestringNoRequired for residential_landlord.
period_amountintegerNocustom: length of the notice period.
period_unitstringNocustom: unit of the notice period.
alignmentstringNocustom: admissible termination dates.
statestringNoGerman federal state whose public holidays apply (e.g. NW, BY, BE). If omitted, only nationwide holidays are used and states with a different result are listed.
regionstringNoOptional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities (Assumption Day), EVANG; SN BZ=Bautzen; TH EIC, UH, WAK.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "regime",
    "desired_end"
  ],
  "properties": {
    "regime": {
      "type": "string",
      "enum": [
        "employment_basic",
        "employment_employer",
        "employment_probation",
        "residential_tenant",
        "residential_landlord",
        "furnished_room",
        "commercial_premises",
        "custom"
      ],
      "description": "employment_basic = § 622(1) (employee, or employer under two years); employment_employer = § 622(2) by service length; employment_probation = § 622(3); residential_* = § 573c(1); furnished_room = § 573c(3); commercial_premises = § 580a(2); custom = contractual period."
    },
    "desired_end": {
      "type": "string",
      "format": "date",
      "description": "Desired last day of the contract."
    },
    "employment_start": {
      "type": "string",
      "format": "date",
      "description": "Required for employment_employer."
    },
    "handover_date": {
      "type": "string",
      "format": "date",
      "description": "Required for residential_landlord."
    },
    "period_amount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "custom: length of the notice period."
    },
    "period_unit": {
      "type": "string",
      "enum": [
        "days",
        "weeks",
        "months"
      ],
      "description": "custom: unit of the notice period."
    },
    "alignment": {
      "type": "string",
      "enum": [
        "any_day",
        "mid_or_month_end",
        "month_end",
        "quarter_end",
        "half_year_end",
        "year_end"
      ],
      "default": "any_day",
      "description": "custom: admissible termination dates."
    },
    "state": {
      "type": "string",
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "German federal state whose public holidays apply (e.g. NW, BY, BE). If omitted, only nationwide holidays are used and states with a different result are listed."
    },
    "region": {
      "type": "string",
      "enum": [
        "A",
        "KATH",
        "EVANG",
        "BZ",
        "EIC",
        "UH",
        "WAK"
      ],
      "description": "Optional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities (Assumption Day), EVANG; SN BZ=Bautzen; TH EIC, UH, WAK."
    }
  }
}

Open original schema

Published input example

{
  "regime": "residential_tenant",
  "desired_end": "2027-01-31",
  "state": "NW"
}

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 →