Skip to content
HALOWERK

Textwerk

cancellation letter

Computes the termination date from the day the letter is received: employment four weeks to the 15th or month end, two weeks during probation, employer periods by completed years of service (§ 622 Abs. 1-3 BGB); residential lease by the tenant on the third working day of a month to the end of the month after next, Saturday counted except as the last day (§ 573c Abs. 1 BGB, public holidays of the state); consumer contracts for regular supply with the § 309 Nr. 9 BGB limits (one month before.

POST https://text.halowerk.com/v1/cancellation-letter

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
contract_typestringYesKind of contract and who terminates.
receipt_datestringYesDay the termination will reach the other party (Zugang).
letter_datestringNoDate of the letter (default: receipt_date).
senderobjectYes
recipientobjectYes
contract_startstringNoStart of employment (employer termination) or of the subscription.
probationbooleanNoEmployment: termination during an agreed probation period of at most six months (§ 622 Abs. 3 BGB).
initial_term_monthsintegerNoconsumer_subscription: agreed initial term in months.
noticeobjectNocustom: contractual notice period.
contract_labelstringNoHow the contract is named in the letter, ideally with article, e.g. "den Mietvertrag über die Wohnung Musterweg 1, 2. OG links".
referencestringNoCustomer, contract or personnel number.
placestringNo
statestringNoGerman federal state whose public holidays apply to the deadline (e.g. NW, BY). Without it only nationwide holidays are used.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "contract_type",
    "receipt_date",
    "sender",
    "recipient"
  ],
  "properties": {
    "contract_type": {
      "type": "string",
      "enum": [
        "employment_by_employee",
        "employment_by_employer",
        "residential_lease_by_tenant",
        "consumer_subscription",
        "custom"
      ],
      "description": "Kind of contract and who terminates."
    },
    "receipt_date": {
      "type": "string",
      "format": "date",
      "description": "Day the termination will reach the other party (Zugang)."
    },
    "letter_date": {
      "type": "string",
      "format": "date",
      "description": "Date of the letter (default: receipt_date)."
    },
    "sender": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "street",
        "postcode",
        "city"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Name or company."
        },
        "addition": {
          "type": "string",
          "maxLength": 120,
          "description": "Optional second address line (department, c/o)."
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Street and house number."
        },
        "postcode": {
          "type": "string",
          "pattern": "^[0-9A-Z -]{3,10}$",
          "description": "Postcode."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "City."
        },
        "country": {
          "type": "string",
          "maxLength": 60,
          "description": "Country, only for addresses abroad."
        }
      }
    },
    "recipient": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "street",
        "postcode",
        "city"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Name or company."
        },
        "addition": {
          "type": "string",
          "maxLength": 120,
          "description": "Optional second address line (department, c/o)."
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Street and house number."
        },
        "postcode": {
          "type": "string",
          "pattern": "^[0-9A-Z -]{3,10}$",
          "description": "Postcode."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "City."
        },
        "country": {
          "type": "string",
          "maxLength": 60,
          "description": "Country, only for addresses abroad."
        }
      }
    },
    "contract_start": {
      "type": "string",
      "format": "date",
      "description": "Start of employment (employer termination) or of the subscription."
    },
    "probation": {
      "type": "boolean",
      "default": false,
      "description": "Employment: termination during an agreed probation period of at most six months (§ 622 Abs. 3 BGB)."
    },
    "initial_term_months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "description": "consumer_subscription: agreed initial term in months."
    },
    "notice": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "amount",
        "unit",
        "to"
      ],
      "properties": {
        "amount": {
          "type": "integer",
          "minimum": 0,
          "maximum": 36
        },
        "unit": {
          "type": "string",
          "enum": [
            "days",
            "weeks",
            "months"
          ]
        },
        "to": {
          "type": "string",
          "enum": [
            "any_day",
            "fifteenth_or_month_end",
            "month_end",
            "quarter_end",
            "year_end"
          ]
        }
      },
      "description": "custom: contractual notice period."
    },
    "contract_label": {
      "type": "string",
      "maxLength": 120,
      "description": "How the contract is named in the letter, ideally with article, e.g. \"den Mietvertrag über die Wohnung Musterweg 1, 2. OG links\"."
    },
    "reference": {
      "type": "string",
      "maxLength": 60,
      "description": "Customer, contract or personnel number."
    },
    "place": {
      "type": "string",
      "maxLength": 60
    },
    "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 to the deadline (e.g. NW, BY). Without it only nationwide holidays are used."
    }
  }
}

Open original schema

Published input example

{
  "contract_type": "residential_lease_by_tenant",
  "receipt_date": "2026-11-03",
  "sender": {
    "name": "Mietpartei Nord",
    "street": "Hallenweg 1",
    "postcode": "48599",
    "city": "Gronau"
  },
  "recipient": {
    "name": "Haus GmbH",
    "street": "Hauptstr. 5",
    "postcode": "48599",
    "city": "Gronau"
  },
  "contract_label": "den Mietvertrag über die Wohnung Hallenweg 1, 2. OG links",
  "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 →