User

Find your free time ("when am I free?")

Returns the authenticated user's OPEN time slots within a date range — the gaps between calendar events, within working hours, sized to duration. This is the single-person case of meeting overlap and reuses the same scheduling engine, so buffer time, working hours, and DST behave identically. Slots in the past are never returned. To list BUSY events instead, use GET /api/me/free-busy.

get/api/me/free-time

Request

  • Base URL: https://api.wondercal.com
  • URL: https://api.wondercal.com/api/me/free-time
  • Auth: HTTP bearer

Query parameters

startstring date-time required
Example:2026-09-07T00:00:00Z

Range start (ISO 8601 date-time). Clamped forward to the current time.

endstring date-time required
Example:2026-09-13T23:59:59Z

Range end (ISO 8601 date-time). Must be after start; the range must not exceed 90 days.

durationinteger
Example:30

Length of each free slot to return, in minutes (the appointment length). Defaults to 30.

respectWorkingHoursboolean

When true (default), only openings inside the user's available days and hours are returned. Set to 'false' to search the whole day, including evenings and weekends.

Response

Free slots for the requested range

Example response

{
  "data": {
    "durationMinutes": 30,
    "timeZone": "America/New_York"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.