Skip to content
HALOWERK

Datenwerk

sla due business hours

Starting at the given instant, business time is consumed window by window in the IANA zone (luxon, DST-aware) until the SLA minutes are used up. Days on the closed list and public holidays (date-holidays 3.38, data CC BY-SA 3.0, type public, country/state/region) are skipped; pause intervals such as "waiting for customer" are cut out. A start outside business hours begins at the next opening. With now the elapsed and remaining business minutes and the breach flag are reported. Schedules with.

POST https://daten.halowerk.com/v1/sla-due-business-hours

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
startstringYesInstant when the clock starts (ISO 8601 with offset or Z).
timezonestringYesIANA zone of the business hours.
sla_minutesintegerYesSLA length in business minutes (e.g. 240 = 4 business hours).
business_hoursobjectNoSimple schedule (default Mon-Fri 09:00-17:00).
scheduleobjectNoDetailed schedule; overrides business_hours. Keys mon..sun with [start, end] windows.
holidaysobjectNoPublic holidays to respect (date-holidays data, type "public" only).
closed_datesarrayNoAdditional closed local dates, e.g. 2026-12-24.
pausesarrayNoIntervals in which the SLA clock stops.
nowstringNoOptional instant for elapsed/remaining status.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "start",
    "timezone",
    "sla_minutes"
  ],
  "properties": {
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "Instant when the clock starts (ISO 8601 with offset or Z)."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA zone of the business hours."
    },
    "sla_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200000,
      "description": "SLA length in business minutes (e.g. 240 = 4 business hours)."
    },
    "business_hours": {
      "type": "object",
      "additionalProperties": false,
      "description": "Simple schedule (default Mon-Fri 09:00-17:00).",
      "properties": {
        "days": {
          "type": "array",
          "minItems": 1,
          "maxItems": 7,
          "uniqueItems": true,
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 7
          }
        },
        "start": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
        },
        "end": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
        }
      }
    },
    "schedule": {
      "type": "object",
      "additionalProperties": false,
      "description": "Detailed schedule; overrides business_hours. Keys mon..sun with [start, end] windows.",
      "properties": {
        "mon": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "tue": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "wed": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "thu": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "fri": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "sat": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        },
        "sun": {
          "type": "array",
          "maxItems": 6,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            }
          }
        }
      }
    },
    "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)."
        }
      }
    },
    "closed_dates": {
      "type": "array",
      "maxItems": 400,
      "items": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "description": "Additional closed local dates, e.g. 2026-12-24."
    },
    "pauses": {
      "type": "array",
      "maxItems": 200,
      "description": "Intervals in which the SLA clock stops.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "from",
          "to"
        ],
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "now": {
      "type": "string",
      "format": "date-time",
      "description": "Optional instant for elapsed/remaining status."
    }
  }
}

Open original schema

Published input example

{
  "start": "2026-11-13T16:00:00+01:00",
  "timezone": "Europe/Berlin",
  "sla_minutes": 240,
  "holidays": {
    "country": "DE",
    "state": "NW"
  }
}

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 โ†’