Skip to content
HALOWERK

Ortwerk

driving time 561

Takes timestamped activities (driving, work, availability, break, rest, unknown) or a plan of durations and applies Regulation (EC) No 561/2006 in the consolidated version of 22 May 2024: Art. 6(1) daily driving 9 h, 10 h at most twice a week; Art. 6(2) 56 h per week; Art. 6(3) 90 h in two consecutive weeks; Art. 7 break after 4.5 h (45 min or 15 + 30 min, 2 × 15 min for occasional passenger services); Art. 8(2) daily rest within 24 h (regular 11 h, split 3 + 9 h, reduced 9 h); Art. 8(4) at.

POST https://ort.halowerk.com/v1/driving-time-561

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
activitiesarrayNoTimestamped activities of one driver (from tachograph data); gaps are filled according to gaps_as.
planobjectNoAlternative to activities: a start time and consecutive durations (useful to check a planned schedule).
gaps_asstringNoHow time not covered by activities and explicit "unknown" periods are treated: rest (default) or unknown (not counted as rest).
week_time_zonestringNoIANA time zone for week boundaries (tachographs record UTC).
occasional_passenger_servicebooleanNoDriver engaged in an occasional passenger service: two 15-minute breaks also satisfy Art. 7 (as amended by Reg. (EU) 2024/1258).
international_goods_transportbooleanNoDriver engaged in international goods transport: allows two consecutive reduced weekly rests outside the Member State of establishment (Art. 8(6) third subparagraph).
rest_locationsarrayNoOptional location of weekly rests for Art. 8(6), 8(8) and 8(8a) checks.
compensation_base_daily_hoursintegerNoPart of a daily rest that is not counted as compensation: 9 h (wording of Art. 8(7), default) or 11 h (conservative).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "activities": {
      "type": "array",
      "maxItems": 6000,
      "description": "Timestamped activities of one driver (from tachograph data); gaps are filled according to gaps_as.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "start",
          "end"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "driving",
              "work",
              "availability",
              "break",
              "rest",
              "unknown"
            ],
            "description": "Activity: driving, work (other work), availability, break, rest or unknown."
          },
          "start": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "Start (inclusive), ISO 8601 with time zone."
          },
          "end": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "End (exclusive), ISO 8601 with time zone."
          }
        }
      }
    },
    "plan": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "start",
        "segments"
      ],
      "description": "Alternative to activities: a start time and consecutive durations (useful to check a planned schedule).",
      "properties": {
        "start": {
          "type": "string",
          "maxLength": 40,
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
          "description": "Start of the first segment."
        },
        "segments": {
          "type": "array",
          "minItems": 1,
          "maxItems": 3000,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "type",
              "minutes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "driving",
                  "work",
                  "availability",
                  "break",
                  "rest",
                  "unknown"
                ],
                "description": "Activity type."
              },
              "minutes": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20160,
                "description": "Duration in minutes."
              }
            }
          }
        }
      }
    },
    "gaps_as": {
      "type": "string",
      "enum": [
        "rest",
        "unknown"
      ],
      "default": "rest",
      "description": "How time not covered by activities and explicit \"unknown\" periods are treated: rest (default) or unknown (not counted as rest)."
    },
    "week_time_zone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "IANA time zone for week boundaries (tachographs record UTC)."
    },
    "occasional_passenger_service": {
      "type": "boolean",
      "default": false,
      "description": "Driver engaged in an occasional passenger service: two 15-minute breaks also satisfy Art. 7 (as amended by Reg. (EU) 2024/1258)."
    },
    "international_goods_transport": {
      "type": "boolean",
      "default": false,
      "description": "Driver engaged in international goods transport: allows two consecutive reduced weekly rests outside the Member State of establishment (Art. 8(6) third subparagraph)."
    },
    "rest_locations": {
      "type": "array",
      "maxItems": 200,
      "description": "Optional location of weekly rests for Art. 8(6), 8(8) and 8(8a) checks.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "at",
          "location"
        ],
        "properties": {
          "at": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "Any time within the rest period."
          },
          "location": {
            "type": "string",
            "enum": [
              "home",
              "operational_centre",
              "abroad",
              "vehicle",
              "other"
            ],
            "description": "home or operational_centre (return), abroad (outside the Member State of establishment and residence), vehicle (in the cab), other."
          }
        }
      }
    },
    "compensation_base_daily_hours": {
      "type": "integer",
      "enum": [
        9,
        11
      ],
      "default": 9,
      "description": "Part of a daily rest that is not counted as compensation: 9 h (wording of Art. 8(7), default) or 11 h (conservative)."
    }
  }
}

Open original schema

Published input example

{
  "plan": {
    "start": "2026-10-04T18:00:00Z",
    "segments": [
      {
        "type": "rest",
        "minutes": 720
      },
      {
        "type": "driving",
        "minutes": 300
      },
      {
        "type": "break",
        "minutes": 45
      },
      {
        "type": "driving",
        "minutes": 270
      },
      {
        "type": "rest",
        "minutes": 660
      }
    ]
  }
}

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 →