Next free slot from now API

Finds the earliest free slot of a given duration at or after an explicit now, fitting inside a daily working window and skipping busy intervals, walking day by day. Answers 'When is my next 1-hour opening?', 'What's the soonest slot given my calendar and working hours?'.

Price$0.02per request

MethodPOST

Route/v1/scheduling/next-available-slot

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingcalendaravailabilitynext-slotbookingworking-hoursintervalsagents

API URLhttps://x402.hexl.dev/v1/scheduling/next-available-slot

Integration docs

Example request

{
  "now": "2026-06-04T09:15:00Z",
  "durationMinutes": 60,
  "busy": [
    {
      "start": "2026-06-04T09:00:00Z",
      "end": "2026-06-04T10:00:00Z"
    }
  ],
  "workStart": "09:00",
  "workEnd": "17:00"
}

Example response

{
  "slot": {
    "start": "2026-06-04T10:00:00.000Z",
    "end": "2026-06-04T11:00:00.000Z"
  },
  "minutesFromNow": 45,
  "searchedDays": 1,
  "found": true,
  "interpretation": "Earliest 60-min slot starts 2026-06-04T10:00:00.000Z (45 min from now)."
}

Input schema

{
  "type": "object",
  "required": [
    "now",
    "durationMinutes"
  ],
  "properties": {
    "now": {
      "type": "string",
      "examples": [
        "2026-06-04T09:15:00Z"
      ]
    },
    "durationMinutes": {
      "type": "number",
      "examples": [
        60
      ]
    },
    "busy": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "workStart": {
      "type": "string",
      "examples": [
        "09:00"
      ]
    },
    "workEnd": {
      "type": "string",
      "examples": [
        "17:00"
      ]
    },
    "horizonDays": {
      "type": "number",
      "examples": [
        14
      ]
    }
  }
}

Output schema

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