Textwerk
defect notice
Computes the deadline for subsequent performance or remedy from the letter date (§§ 187 Abs. 1, 188 Abs. 1, 193 BGB with public holidays) and the end of the limitation period: two years from delivery for goods, five years for buildings and building materials (§ 438 Abs. 1, 2 BGB), two or five years from acceptance for works (§ 634a Abs. 1, 2 BGB), with a warning when less than three months remain. Adds the presumption of § 477 BGB for consumer purchases within one year, the inspection and.
POST https://text.halowerk.com/v1/defect-noticeInputs
| Field | Type | Required | Description |
|---|---|---|---|
| contract_type | string | Yes | Kind of contract. |
| letter_date | string | Yes | |
| subject | string | Yes | What is defective, e.g. "Waschmaschine Modell X, Kaufvertrag vom 10.03.2026". |
| defects | array | Yes | Description of each defect. |
| delivery_date | string | No | Purchase: day of delivery (Ablieferung). |
| acceptance_date | string | No | Work: day of acceptance (Abnahme). |
| discovered_date | string | No | Day the defect was discovered. |
| building_material | boolean | No | Purchase: item was used for a building and caused its defect (five years, § 438 Abs. 1 Nr. 2 lit. b BGB). |
| remedy | string | No | Purchase: requested kind of subsequent performance (buyer's choice, § 439 Abs. 1 BGB). |
| remedy_days | integer | No | Days for remedy (service default 14; the period must be reasonable). |
| sender | object | Yes | |
| recipient | object | Yes | |
| 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",
"letter_date",
"subject",
"defects",
"sender",
"recipient"
],
"properties": {
"contract_type": {
"type": "string",
"enum": [
"purchase",
"consumer_purchase",
"commercial_purchase",
"work",
"building_work",
"lease"
],
"description": "Kind of contract."
},
"letter_date": {
"type": "string",
"format": "date"
},
"subject": {
"type": "string",
"minLength": 3,
"maxLength": 200,
"description": "What is defective, e.g. \"Waschmaschine Modell X, Kaufvertrag vom 10.03.2026\"."
},
"defects": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"description": "Description of each defect."
},
"delivery_date": {
"type": "string",
"format": "date",
"description": "Purchase: day of delivery (Ablieferung)."
},
"acceptance_date": {
"type": "string",
"format": "date",
"description": "Work: day of acceptance (Abnahme)."
},
"discovered_date": {
"type": "string",
"format": "date",
"description": "Day the defect was discovered."
},
"building_material": {
"type": "boolean",
"default": false,
"description": "Purchase: item was used for a building and caused its defect (five years, § 438 Abs. 1 Nr. 2 lit. b BGB)."
},
"remedy": {
"type": "string",
"enum": [
"repair",
"replacement",
"either"
],
"default": "either",
"description": "Purchase: requested kind of subsequent performance (buyer's choice, § 439 Abs. 1 BGB)."
},
"remedy_days": {
"type": "integer",
"minimum": 7,
"maximum": 60,
"default": 14,
"description": "Days for remedy (service default 14; the period must be reasonable)."
},
"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."
}
}
},
"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": "consumer_purchase",
"letter_date": "2026-11-02",
"subject": "Waschmaschine Modell X, gekauft am 10.03.2026",
"defects": [
"Die Trommel dreht sich im Schleudergang nicht."
],
"delivery_date": "2026-03-10",
"discovered_date": "2026-10-20",
"sender": {
"name": "Einkaufsteam Nord",
"street": "Weg 1",
"postcode": "48599",
"city": "Gronau"
},
"recipient": {
"name": "Elektro GmbH",
"street": "Str. 2",
"postcode": "48599",
"city": "Gronau"
},
"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