Skip to main content
POST
Returns open time slots, grouped by date, for an event type between startTime and endTime. Identify the event type in one of two ways:
  • By ID — pass eventTypeId. This is the most common option.
  • By username and slug — pass usernameList and eventTypeSlug together. Use this for dynamic or multi-host events.
You must send either eventTypeId, or both usernameList and eventTypeSlug. Sending neither returns 400.

Body

string
required
Start of the date range, in ISO 8601.
string
required
End of the date range, in ISO 8601.
integer
ID of the event type. Required unless you send usernameList and eventTypeSlug.
string[]
Usernames of the hosts. Use with eventTypeSlug.
string
Slug of the event type. Use with usernameList.
string
IANA time zone used to group slots by date, e.g. America/New_York.
string
Duration in minutes, as a string. For event types that offer multiple durations.
string
UID of a booking being rescheduled. Its current slot is not treated as busy.
boolean
Set to true for team event types.
string
Organization slug, for organization event types.
string
Email of the person booking.
string
Limit round-robin availability to this host’s username.
boolean
Start results from the first available day.
boolean
Include debugging information in the response.

Response

object
Available slots keyed by date (YYYY-MM-DD).