Skip to content
HALOWERK

Datenwerk

roster check

Shifts are local date-times in an IANA zone (luxon, real elapsed time across DST). Breaks of at least 15 minutes count as rest breaks (§ 4 Satz 2); shorter interruptions count as working time. Checks: daily working time above 8 h (warning: needs compensation to an 8 h average within 6 calendar months or 24 weeks) and above 10 h (violation, § 3); required breaks of 30/45 minutes after more than 6/9 hours and no more than 6 hours without a break (§ 4); at least 11 hours of rest between working.

POST https://daten.halowerk.com/v1/roster-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
timezonestringNo
shiftsarrayYesPlanned or worked shifts (use pseudonymous employee IDs).
werktag_modelstringNocalendar_day: work grouped by start date; rolling_24h: 24 hours from the first start of the working day.
rest_reduction_sectorbooleanNoEmployer belongs to a sector of § 5 Abs. 2 ArbZG (hospitals, care, hospitality, transport, broadcasting, agriculture).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "shifts"
  ],
  "properties": {
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "default": "Europe/Berlin"
    },
    "shifts": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2000,
      "description": "Planned or worked shifts (use pseudonymous employee IDs).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "employee",
          "start",
          "end"
        ],
        "properties": {
          "employee": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Employee ID or pseudonym."
          },
          "start": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
            "description": "Local start, e.g. 2026-11-16T08:00."
          },
          "end": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
            "description": "Local end (may be on the next day)."
          },
          "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([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$"
                },
                "end": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$"
                }
              }
            }
          },
          "break_minutes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 600,
            "description": "Total break when positions are unknown (counted as one rest break)."
          }
        }
      }
    },
    "werktag_model": {
      "type": "string",
      "enum": [
        "calendar_day",
        "rolling_24h"
      ],
      "default": "calendar_day",
      "description": "calendar_day: work grouped by start date; rolling_24h: 24 hours from the first start of the working day."
    },
    "rest_reduction_sector": {
      "type": "boolean",
      "default": false,
      "description": "Employer belongs to a sector of § 5 Abs. 2 ArbZG (hospitals, care, hospitality, transport, broadcasting, agriculture)."
    }
  }
}

Open original schema

Published input example

{
  "timezone": "Europe/Berlin",
  "shifts": [
    {
      "employee": "E1",
      "start": "2026-11-16T08:00",
      "end": "2026-11-16T19:00",
      "breaks": [
        {
          "start": "2026-11-16T12:00",
          "end": "2026-11-16T12:30"
        }
      ]
    },
    {
      "employee": "E1",
      "start": "2026-11-17T05:30",
      "end": "2026-11-17T13: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 →