Fairest cross-timezone time API

Ranks candidate meeting instants by fairness across timezones, computing each participant's local time from their UTC offset and penalizing time outside their (weighted) working window. Answers 'Which UTC time is least painful for everyone across timezones?', 'What's the fairest meeting slot for a global team?'.

Price$0.03per request

MethodPOST

Route/v1/scheduling/best-meeting-time

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingmeetingstimezonefairnessglobal-teamtz-offsetcoordinationagents

API URLhttps://x402.hexl.dev/v1/scheduling/best-meeting-time

Integration docs

Example request

{
  "candidatesUtc": [
    "2026-06-04T14:00:00Z",
    "2026-06-04T16:00:00Z"
  ],
  "durationMinutes": 60,
  "participants": [
    {
      "id": "ny",
      "utcOffsetMinutes": -240
    },
    {
      "id": "lon",
      "utcOffsetMinutes": 60
    }
  ]
}

Example response

{
  "durationMinutes": 60,
  "candidatesEvaluated": 2,
  "ranked": [
    {
      "utcStart": "2026-06-04T14:00:00.000Z",
      "totalPenaltyHours": 0,
      "participants": [
        {
          "id": "ny",
          "localStart": "10:00",
          "localEnd": "11:00",
          "withinHours": true,
          "penaltyHours": 0
        },
        {
          "id": "lon",
          "localStart": "15:00",
          "localEnd": "16:00",
          "withinHours": true,
          "penaltyHours": 0
        }
      ]
    },
    {
      "utcStart": "2026-06-04T16:00:00.000Z",
      "totalPenaltyHours": 1,
      "participants": [
        {
          "id": "ny",
          "localStart": "12:00",
          "localEnd": "13:00",
          "withinHours": true,
          "penaltyHours": 0
        },
        {
          "id": "lon",
          "localStart": "17:00",
          "localEnd": "18:00",
          "withinHours": false,
          "penaltyHours": 1
        }
      ]
    }
  ],
  "best": {
    "utcStart": "2026-06-04T14:00:00.000Z",
    "totalPenaltyHours": 0
  },
  "interpretation": "Best slot 2026-06-04T14:00:00.000Z is inside everyone's working hours."
}

Input schema

{
  "type": "object",
  "required": [
    "candidatesUtc",
    "durationMinutes",
    "participants"
  ],
  "properties": {
    "candidatesUtc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "examples": [
        [
          "2026-06-04T14:00:00Z",
          "2026-06-04T16:00:00Z"
        ]
      ]
    },
    "durationMinutes": {
      "type": "number",
      "examples": [
        60
      ]
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

Output schema

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