Skip to content
HALOWERK

Rechenwerk

deadline bgb

Implements § 187(1) (event day not counted) and § 187(2) (start day counted), § 188(1) day periods, § 188(2) week/month/year periods, § 188(3) month-end rule, § 189 quarters/half years/half months and § 193 BGB (deadline falling on Saturday, Sunday or a public holiday at the place of declaration moves to the next working day; § 222(2) ZPO and § 108(3) AO work the same way). Holidays per federal state and sub-region from date-holidays 3.38.0 (dates 1995-2099). Without a state it uses.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
start_datestringYesDate of the triggering event (e.g. receipt, delivery, service) or, for start_type start_of_day, the first day of the period.
start_typestringNoevent = § 187(1) BGB (event day not counted); start_of_day = § 187(2) BGB (start day counted, e.g. a term starting on a calendar date).
amountintegerYesLength of the period in the chosen unit.
unitstringYesUnit of the period (§ 189 BGB: quarter = 3 months, half year = 6 months).
plus_half_monthbooleanNoAdd a half month (15 days, counted last, § 189(2) BGB), e.g. for "one and a half months".
apply_193booleanNoApply § 193 BGB. Set false for notice periods (BGH III ZR 172/04: § 193 does not apply to notice periods).
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": [
    "start_date",
    "amount",
    "unit"
  ],
  "properties": {
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Date of the triggering event (e.g. receipt, delivery, service) or, for start_type start_of_day, the first day of the period."
    },
    "start_type": {
      "type": "string",
      "enum": [
        "event",
        "start_of_day"
      ],
      "default": "event",
      "description": "event = § 187(1) BGB (event day not counted); start_of_day = § 187(2) BGB (start day counted, e.g. a term starting on a calendar date)."
    },
    "amount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3660,
      "description": "Length of the period in the chosen unit."
    },
    "unit": {
      "type": "string",
      "enum": [
        "days",
        "weeks",
        "months",
        "quarters",
        "half_years",
        "years"
      ],
      "description": "Unit of the period (§ 189 BGB: quarter = 3 months, half year = 6 months)."
    },
    "plus_half_month": {
      "type": "boolean",
      "default": false,
      "description": "Add a half month (15 days, counted last, § 189(2) BGB), e.g. for \"one and a half months\"."
    },
    "apply_193": {
      "type": "boolean",
      "default": true,
      "description": "Apply § 193 BGB. Set false for notice periods (BGH III ZR 172/04: § 193 does not apply to notice periods)."
    },
    "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

{
  "start_date": "2026-05-21",
  "amount": 2,
  "unit": "weeks",
  "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 →