POST
/
v2
/
routing-forms
/
{routingFormId}
/
calculate-slots
curl --request POST \
  --url https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots \
  --header 'Authorization: <authorization>'
{
  "status": "success",
  "data": {
    "eventTypeId": 123,
    "slots": {}
  }
}

Headers

​
Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_

Path Parameters

​
routingFormId
string
required

Query Parameters

​
start
string
required
  Time starting from which available slots should be checked.

  Must be in UTC timezone as ISO 8601 datestring.
  
  You can pass date without hours which defaults to start of day or specify hours:
  2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z
​
end
string
required
  Time until which available slots should be checked.
  
  Must be in UTC timezone as ISO 8601 datestring.
  
  You can pass date without hours which defaults to end of day or specify hours:
  2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z
​
timeZone
string

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

​
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.

​
format
enum<string>

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

Available options:
range,
time

Response

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

"success"

​
data
object
required

Was this page helpful?

Suggest editsRaise issue