Working-hours overlap of zones API

Computes the UTC window during which the local working hours of N timezones all overlap, shifting each zone's local window by its offset and intersecting. Answers 'When are all my distributed teammates simultaneously at work?', 'Is there any working-hours overlap between these timezones?'.

Price$0.02per request

MethodPOST

Route/v1/scheduling/working-hours-overlap

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingtimezoneoverlapworking-hoursdistributed-teamtz-offsetintersectioncoordination

API URLhttps://x402.hexl.dev/v1/scheduling/working-hours-overlap

Integration docs

Example request

{
  "zones": [
    {
      "id": "ny",
      "utcOffsetMinutes": -240
    },
    {
      "id": "lon",
      "utcOffsetMinutes": 60
    }
  ]
}

Example response

{
  "zoneCount": 2,
  "overlapMinutes": 180,
  "overlapHours": 3,
  "hasOverlap": true,
  "overlapUtc": {
    "start": "13:00",
    "end": "16:00"
  },
  "perZoneLocal": [
    {
      "id": "ny",
      "localStart": "09:00",
      "localEnd": "12:00"
    },
    {
      "id": "lon",
      "localStart": "14:00",
      "localEnd": "17:00"
    }
  ],
  "interpretation": "3h overlap; UTC 13:00–16:00."
}

Input schema

{
  "type": "object",
  "required": [
    "zones"
  ],
  "properties": {
    "zones": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "examples": [
        [
          {
            "id": "ny",
            "utcOffsetMinutes": -240
          },
          {
            "id": "lon",
            "utcOffsetMinutes": 60
          }
        ]
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}