Skip to content
HALOWERK

Rechenwerk

withdrawal deadline

Determines the start event of the 14-day withdrawal period: receipt of the goods, of the last item or partial shipment, or of the first delivery of a subscription (§ 356(2) no. 1 a-d BGB), contract conclusion for services (§ 355(2)) and for utilities and digital content without a medium (§ 356(2) no. 2). The period does not start before proper withdrawal information (§ 356(3)); without it the right expires 12 months and 14 days after the start event (§ 356(4)). Day of the event not counted.

POST https://rechen.halowerk.com/v1/withdrawal-deadline

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
contract_typestringYesgoods_single: one delivery; goods_multiple_separate: several goods of one order delivered separately; goods_partial_shipments: one item in parts; goods_regular_delivery: subscription; services; digital_content not on a physical medium; utilities: water, gas, electricity, district heating.
contract_datestringYesDate the contract was concluded.
deliveriesarrayNoDates on which the consumer (or a named third party, not the carrier) received goods; required for goods types.
information_datestringNoDate proper withdrawal information was received, if later than the start event.
informedbooleanNofalse if no proper withdrawal information was ever given (12-month cap applies).
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": [
    "contract_type",
    "contract_date"
  ],
  "properties": {
    "contract_type": {
      "type": "string",
      "enum": [
        "goods_single",
        "goods_multiple_separate",
        "goods_partial_shipments",
        "goods_regular_delivery",
        "services",
        "digital_content",
        "utilities"
      ],
      "description": "goods_single: one delivery; goods_multiple_separate: several goods of one order delivered separately; goods_partial_shipments: one item in parts; goods_regular_delivery: subscription; services; digital_content not on a physical medium; utilities: water, gas, electricity, district heating."
    },
    "contract_date": {
      "type": "string",
      "format": "date",
      "description": "Date the contract was concluded."
    },
    "deliveries": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "format": "date"
      },
      "description": "Dates on which the consumer (or a named third party, not the carrier) received goods; required for goods types."
    },
    "information_date": {
      "type": "string",
      "format": "date",
      "description": "Date proper withdrawal information was received, if later than the start event."
    },
    "informed": {
      "type": "boolean",
      "default": true,
      "description": "false if no proper withdrawal information was ever given (12-month cap applies)."
    },
    "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

{
  "contract_type": "goods_partial_shipments",
  "contract_date": "2026-04-05",
  "deliveries": [
    "2026-04-10",
    "2026-04-17"
  ],
  "state": "BE"
}

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 →