Skip to main content
GET
Get available slots

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Query Parameters

eventTypeId
string

Event type ID to fetch availability for. Required unless eventTypeSlug includes owner context (<username>/<slug> or team/<teamSlug>/<slug>) or is paired with usernameList.

Pattern: ^[1-9]\d*$
Example:

"123"

eventTypeSlug
string

Event type slug used for slug-based slot lookup. Supports values like discovery-call-30 or <username>/<slug> and team/<teamSlug>/<slug>.

Example:

"discovery-call-30"

usernameList

One or more usernames for slug-based lookup. A single username value is also accepted and normalized to an array.

Example:
start
string
required

Availability window start timestamp.

Minimum string length: 1
Example:

"2026-05-01T00:00:00.000Z"

end
string
required

Availability window end timestamp.

Minimum string length: 1
Example:

"2026-05-07T23:59:59.000Z"

timeZone
string

IANA timezone used to return slots.

Example:

"Asia/Kolkata"

duration
integer

Optional slot duration in minutes.

Required range: x >= 1
Example:

30

format
enum<string>

Slot format preference.

Available options:
time,
range
Example:

"time"

bookingUidToReschedule
string

Booking UID being rescheduled, used to include the original booking slot in availability.

Example:

"2f33b5cd-8ec7-4eb0-91fd-9488c30f4744"

isTeamEvent
boolean

Whether lookup should be treated as a team event flow.

Example:

false

Response

GetSlotsResponse

GetSlotsResponse

success
enum<boolean>
required
Available options:
true
data
object
message
string
meta
object