Skip to content
HALOWERK

Datenwerk

slot finder

Parses each ICS with ical.js (VEVENT, VTIMEZONE definitions inside the file, IANA TZIDs without VTIMEZONE resolved with luxon, all-day events, VFREEBUSY periods); recurring events are expanded with rrule.js on local wall-clock time after an RFC 5545 rule check (rules that can never occur are rejected), with RDATE, EXDATE and RECURRENCE-ID overrides. Cancelled and transparent events do not block; tentative ones block unless disabled. Busy times of all calendars are merged and subtracted from.

POST https://daten.halowerk.com/v1/slot-finder

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
calendarsarrayYesiCalendar texts (RFC 5545), e.g. exported .ics files or CalDAV responses.
date_fromstringYesFirst day of the search range (local date in timezone).
date_tostringYesLast day of the search range (inclusive).
timezonestringYesIANA zone for working hours and output, e.g. Europe/Berlin.
working_hoursobjectNoDaily window that may be booked (default Mon-Fri 09:00-17:00).
min_duration_minutesintegerNoShortest free window to report.
buffer_minutesintegerNoPadding added before and after every busy block.
tentative_is_busybooleanNoTreat STATUS:TENTATIVE events and BUSY-TENTATIVE periods as busy.
exclude_holidaysobjectNoPublic holidays to respect (date-holidays data, type "public" only).
max_slotsintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "calendars",
    "date_from",
    "date_to",
    "timezone"
  ],
  "properties": {
    "calendars": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "iCalendar texts (RFC 5545), e.g. exported .ics files or CalDAV responses.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "ics"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "description": "Label used in the report."
          },
          "ics": {
            "type": "string",
            "minLength": 15,
            "maxLength": 1000000,
            "description": "Complete VCALENDAR text."
          }
        }
      }
    },
    "date_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day of the search range (local date in timezone)."
    },
    "date_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day of the search range (inclusive)."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA zone for working hours and output, e.g. Europe/Berlin."
    },
    "working_hours": {
      "type": "object",
      "additionalProperties": false,
      "description": "Daily window that may be booked (default Mon-Fri 09:00-17:00).",
      "properties": {
        "start": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
          "default": "09:00"
        },
        "end": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
          "default": "17:00"
        },
        "days": {
          "type": "array",
          "minItems": 1,
          "maxItems": 7,
          "uniqueItems": true,
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 7
          },
          "description": "ISO weekdays, 1 = Monday ... 7 = Sunday."
        }
      }
    },
    "min_duration_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 1440,
      "default": 30,
      "description": "Shortest free window to report."
    },
    "buffer_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120,
      "default": 0,
      "description": "Padding added before and after every busy block."
    },
    "tentative_is_busy": {
      "type": "boolean",
      "default": true,
      "description": "Treat STATUS:TENTATIVE events and BUSY-TENTATIVE periods as busy."
    },
    "exclude_holidays": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "country"
      ],
      "description": "Public holidays to respect (date-holidays data, type \"public\" only).",
      "properties": {
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "ISO 3166-1 alpha-2 country code, e.g. DE."
        },
        "state": {
          "type": "string",
          "maxLength": 6,
          "description": "Optional state/subdivision code, e.g. NW or BY."
        },
        "region": {
          "type": "string",
          "maxLength": 10,
          "description": "Optional region code below the state, e.g. A (Augsburg)."
        }
      }
    },
    "max_slots": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    }
  }
}

Open original schema

Published input example

{
  "calendars": [
    {
      "name": "anna",
      "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//HALOWERK//Stock review//DE\r\nBEGIN:VTIMEZONE\r\nTZID:Europe/Berlin\r\nBEGIN:DAYLIGHT\r\nTZOFFSETFROM:+0100\r\nTZOFFSETTO:+0200\r\nTZNAME:CEST\r\nDTSTART:19700329T020000\r\nRRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU\r\nEND:DAYLIGHT\r\nBEGIN:STANDARD\r\nTZOFFSETFROM:+0200\r\nTZOFFSETTO:+0100\r\nTZNAME:CET\r\nDTSTART:19701025T030000\r\nRRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU\r\nEND:STANDARD\r\nEND:VTIMEZONE\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T100000\r\nDTEND;TZID=Europe/Berlin:20261116T110000\r\nSUMMARY:Review\r\nEND:VEVENT\r\nEND:VCALENDAR"
    },
    {
      "name": "ben",
      "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//HALOWERK//Stock review//DE\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T130000\r\nDTEND;TZID=Europe/Berlin:20261116T143000\r\nSUMMARY:Workshop\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T150000\r\nDTEND;TZID=Europe/Berlin:20261116T160000\r\nTRANSP:TRANSPARENT\r\nSUMMARY:Focus (free)\r\nEND:VEVENT\r\nEND:VCALENDAR"
    }
  ],
  "date_from": "2026-11-16",
  "date_to": "2026-11-16",
  "timezone": "Europe/Berlin",
  "working_hours": {
    "start": "09:00",
    "end": "17:00"
  },
  "min_duration_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 โ†’