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-letterInputs
| Field | Type | Required | Description |
|---|---|---|---|
| contract_type | string | Yes | Kind of contract and who terminates. |
| receipt_date | string | Yes | Day the termination will reach the other party (Zugang). |
| letter_date | string | No | Date of the letter (default: receipt_date). |
| sender | object | Yes | |
| recipient | object | Yes | |
| contract_start | string | No | Start of employment (employer termination) or of the subscription. |
| probation | boolean | No | Employment: termination during an agreed probation period of at most six months (§ 622 Abs. 3 BGB). |
| initial_term_months | integer | No | consumer_subscription: agreed initial term in months. |
| notice | object | No | custom: contractual notice period. |
| contract_label | string | No | How the contract is named in the letter, ideally with article, e.g. "den Mietvertrag über die Wohnung Musterweg 1, 2. OG links". |
| reference | string | No | Customer, contract or personnel number. |
| place | string | No | |
| state | string | No | German 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."
}
}
}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
- Textwerk0.002 USDC
acronym ideas
POSThttps://text.halowerk.com/v1/acronym-ideasSplits the title into words, marks German and English stop words (and, of, für, und ), and enumerates in word order every combination of the first 1-3 letters of each significant word (stop words contribute 0 or 1 letter when allowed), with
- Textwerk0.005 USDC
agg check
POSThttps://text.halowerk.com/v1/agg-checkApplies documented rules to the ad text and its first line or title: explicit age limits and age ranges, youth-related team wording and career-stage target groups (age); native-speaker, accent and origin requirements, nationality (ethnic or
- Textwerk0.002 USDC
anglicism replace
POSThttps://text.halowerk.com/v1/anglicism-replaceLooks up every word in about 1,050 entries that OpenThesaurus (export 2026-10-30, LGPL-2.1 or CC BY-SA 4.0) labels English, Anglicism or Denglisch, matching inflected forms from german-pos-dict 1.2.2 (CC BY-SA 4.0) and English heads of comp