Skip to main content
POST
Calculate slots based on routing form response

Headers

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

routingFormId
string
required

Query Parameters

start
string
required
Example:

"2050-09-05"

end
string
required
Example:

"2050-09-06"

timeZone
string

Time zone in which the available slots should be returned. Defaults to UTC.

Example:

"Europe/Rome"

duration
number

If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.

Example:

"60"

format
enum<string>

Format of slot times in response. Use 'range' to get start and end times.

Available options:
range,
time
Example:

"range"

bookingUidToReschedule
string

The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.

Example:

"abc123def456"

rescheduleWithSameHost
boolean

Only for round robin event types that allow the person rescheduling to choose the host. True returns slots of the original host, false returns slots of any available host. Ignored for other event types.

Example:

true

Body

application/json

The routing form response, as a map of field identifier to answer. Answers use the option label, not the option id. Must not be empty - without answers no route can match.

{key}
string

Response

200 - application/json
status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
object
required