Skip to content
HALOWERK

Rechenwerk

working time check

For a single person (several employers are added up, § 2(1) ArbZG) it checks per working day the 8/10-hour limit (§ 3), breaks of 30/45 minutes in blocks of at least 15 minutes and no more than six hours without a break (§ 4), 11 hours of rest or 10 hours with compensation in the sectors of § 5(2), and over the whole record the compensation average of 8 hours per working day within 24 weeks or six calendar months (vacation and sick days neutral, holidays not counted as working days), night.

POST https://rechen.halowerk.com/v1/working-time-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
entriesarrayYesWorked periods of one person in German local time.
statestringNoFederal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used.
regionstringNoOptional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK.
absencesarrayNoDays of leave or sickness (neutral for averages, not counted as replacement rest days).
period_startstringNoFirst day covered by the record (default: first entry).
period_endstringNoLast day covered by the record (default: last entry).
compensation_periodstringNoCompensation period of § 3 sentence 2 ArbZG.
night_shift_rotationbooleanNoWorks night shifts in alternating shifts as a rule (§ 2(5) no. 1 ArbZG).
bakerybooleanNoBakery or confectionery: night time 22-5 h (§ 2(3) ArbZG).
rest_reduction_sectorbooleanNoSector of § 5(2) ArbZG (hospitals, care, hospitality, transport, broadcasting, agriculture).
minorbooleanNoPerson under 18 (then the JArbSchG applies instead).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "entries"
  ],
  "properties": {
    "entries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "description": "Worked periods of one person in German local time.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "start",
          "end"
        ],
        "properties": {
          "start": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
            "description": "Local start, e.g. 2026-11-09T08:00."
          },
          "end": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
            "description": "Local end."
          },
          "breaks": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "start",
                "end"
              ],
              "properties": {
                "start": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"
                },
                "end": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"
                }
              }
            },
            "description": "Breaks with position; interruptions under 15 minutes count as working time."
          },
          "break_minutes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 600,
            "description": "Total break when positions are unknown (counted as one break if at least 15 minutes)."
          },
          "employer": {
            "type": "string",
            "maxLength": 60,
            "description": "Pseudonymous employer label for people with several jobs."
          }
        }
      }
    },
    "state": {
      "type": "string",
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "Federal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used."
    },
    "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, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK."
    },
    "absences": {
      "type": "array",
      "maxItems": 400,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "type"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "type": {
            "type": "string",
            "enum": [
              "vacation",
              "sick",
              "other_paid_leave"
            ]
          }
        }
      },
      "description": "Days of leave or sickness (neutral for averages, not counted as replacement rest days)."
    },
    "period_start": {
      "type": "string",
      "format": "date",
      "description": "First day covered by the record (default: first entry)."
    },
    "period_end": {
      "type": "string",
      "format": "date",
      "description": "Last day covered by the record (default: last entry)."
    },
    "compensation_period": {
      "type": "string",
      "enum": [
        "24_weeks",
        "6_calendar_months"
      ],
      "default": "24_weeks",
      "description": "Compensation period of § 3 sentence 2 ArbZG."
    },
    "night_shift_rotation": {
      "type": "boolean",
      "default": false,
      "description": "Works night shifts in alternating shifts as a rule (§ 2(5) no. 1 ArbZG)."
    },
    "bakery": {
      "type": "boolean",
      "default": false,
      "description": "Bakery or confectionery: night time 22-5 h (§ 2(3) ArbZG)."
    },
    "rest_reduction_sector": {
      "type": "boolean",
      "default": false,
      "description": "Sector of § 5(2) ArbZG (hospitals, care, hospitality, transport, broadcasting, agriculture)."
    },
    "minor": {
      "type": "boolean",
      "default": false,
      "description": "Person under 18 (then the JArbSchG applies instead)."
    }
  }
}

Open original schema

Published input example

{
  "state": "NW",
  "entries": [
    {
      "start": "2026-11-09T07:00",
      "end": "2026-11-09T18:30",
      "breaks": [
        {
          "start": "2026-11-09T12:00",
          "end": "2026-11-09T12:30"
        }
      ]
    },
    {
      "start": "2026-11-10T08:00",
      "end": "2026-11-10T16:30",
      "break_minutes": 30
    }
  ]
}

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 →