Users & availability
Get availability
Fetch available time slots for an event type over a date range.
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
usernameListandeventTypeSlugtogether. Use this for dynamic or multi-host events.
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).