Headers
For non-platform customers - value must be Bearer <token>
where <token>
is api key prefixed with cal_
For platform customers - OAuth client secret key
For platform customers - OAuth client ID
Query Parameters
Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.
"?status=upcoming,past"
Filter bookings by the attendee's email address.
"example@domain.com"
Filter bookings by the attendee's name.
"John Doe"
Filter bookings by event type ids belonging to the team. Event type ids must be separated by a comma.
"?eventTypeIds=100,200"
Filter bookings by event type id belonging to the team.
"?eventTypeId=100"
Filter bookings with start after this date string.
"?afterStart=2025-03-07T10:00:00.000Z"
Filter bookings with end before this date string.
"?beforeEnd=2025-03-07T11:00:00.000Z"
Sort results by their start time in ascending or descending order.
asc
, desc
"?sortStart=asc OR ?sortStart=desc"
Sort results by their end time in ascending or descending order.
asc
, desc
"?sortEnd=asc OR ?sortEnd=desc"
Sort results by their creation time (when booking was made) in ascending or descending order.
asc
, desc
"?sortCreated=asc OR ?sortCreated=desc"
The number of items to return
1 <= x <= 250
10
The number of items to skip
x >= 0
0
Response
The response is of type object
.