Skip to content
HALOWERK

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-notice

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
contract_typestringYesKind of contract.
letter_datestringYes
subjectstringYesWhat is defective, e.g. "Waschmaschine Modell X, Kaufvertrag vom 10.03.2026".
defectsarrayYesDescription of each defect.
delivery_datestringNoPurchase: day of delivery (Ablieferung).
acceptance_datestringNoWork: day of acceptance (Abnahme).
discovered_datestringNoDay the defect was discovered.
building_materialbooleanNoPurchase: item was used for a building and caused its defect (five years, § 438 Abs. 1 Nr. 2 lit. b BGB).
remedystringNoPurchase: requested kind of subsequent performance (buyer's choice, § 439 Abs. 1 BGB).
remedy_daysintegerNoDays for remedy (service default 14; the period must be reasonable).
senderobjectYes
recipientobjectYes
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",
    "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."
    }
  }
}

Open original schema

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

All endpoints in this hub →