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-finderInputs
| Field | Type | Required | Description |
|---|---|---|---|
| calendars | array | Yes | iCalendar texts (RFC 5545), e.g. exported .ics files or CalDAV responses. |
| date_from | string | Yes | First day of the search range (local date in timezone). |
| date_to | string | Yes | Last day of the search range (inclusive). |
| timezone | string | Yes | IANA zone for working hours and output, e.g. Europe/Berlin. |
| working_hours | object | No | Daily window that may be booked (default Mon-Fri 09:00-17:00). |
| min_duration_minutes | integer | No | Shortest free window to report. |
| buffer_minutes | integer | No | Padding added before and after every busy block. |
| tentative_is_busy | boolean | No | Treat STATUS:TENTATIVE events and BUSY-TENTATIVE periods as busy. |
| exclude_holidays | object | No | Public holidays to respect (date-holidays data, type "public" only). |
| max_slots | integer | No |
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
}
}
}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
- Datenwerk0.002 USDC
agenda timebox
POSThttps://daten.halowerk.com/v1/agenda-timeboxItems are scheduled in the given order from the start time, with an optional buffer between items and a break inserted after the item that reaches the break interval. If a total length is set and the plan is too long, overflow=compress shor
- Datenwerk0.003 USDC
approval quorum
POSThttps://daten.halowerk.com/v1/approval-quorumCreates three separate role links for one immutable proposal and action SHA-256. Two approved links yield approved; two rejected links yield rejected. Otherwise the round stays pending until expiry. POST quorum_id and access_token to status
- Datenwerk0.003 USDC
bank csv unify
POSThttps://daten.halowerk.com/v1/bank-csv-unifyNo bank-specific layouts are assumed: the header row (preamble lines before it are skipped) is matched against a documented list of German and English column terms (Buchungstag, Valuta/Wertstellung, Betrag/Umsatz, Soll/Haben, Auftraggeber/E