Calculate slots based on routing form response

It will not actually save the response just return the routed event type and slots when it can be booked.

POST /v2/routing-forms/{routingFormId}/calculate-slots

Calculate slots based on routing form response

cURL

curl --request POST \
  --url https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots"

headers = {"Authorization": "<authorization>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<authorization>'}};

fetch('https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

200

{
  "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

Example:

"2050-09-05"

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

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"

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object · required

Show child attributes