Get booking references

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

If accessed using an OAuth access token, the BOOKING_READ scope is required.

GET /v2/bookings/{bookingUid}/references

Get booking references

cURL

curl --request GET \
  --url https://api.cal.com/v2/bookings/{bookingUid}/references \
  --header 'Authorization: <authorization>' \
  --header 'cal-api-version: <cal-api-version>'

import requests

url = "https://api.cal.com/v2/bookings/{bookingUid}/references"

headers = {
    "cal-api-version": "<cal-api-version>",
    "Authorization": "<authorization>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'cal-api-version': '<cal-api-version>', Authorization: '<authorization>'}
};

fetch('https://api.cal.com/v2/bookings/{bookingUid}/references', 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/bookings/{bookingUid}/references",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "cal-api-version: <cal-api-version>"
  ],
]);

$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/bookings/{bookingUid}/references"

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

	req.Header.Add("cal-api-version", "<cal-api-version>")
	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.get("https://api.cal.com/v2/bookings/{bookingUid}/references")
  .header("cal-api-version", "<cal-api-version>")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cal.com/v2/bookings/{bookingUid}/references")

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

request = Net::HTTP::Get.new(url)
request["cal-api-version"] = '<cal-api-version>'
request["Authorization"] = '<authorization>'

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

200

{
  "status": "success",
  "data": [
    {
      "type": "<string>",
      "eventUid": "<string>",
      "destinationCalendarId": "<string>",
      "id": 123
    }
  ]
}

Headers

cal-api-version · string · default: 2026-02-25 · required

Must be set to 2026-02-25.

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

bookingUid · string · required

Query Parameters

type · enum<string>

Filter booking references by type

Available options: google_calendar, office365_calendar, daily_video, google_video, office365_video, zoom_video

Example:

"google_calendar"

Response

200 - application/json

status · enum<string> · required

The status of the request, always 'success' for successful responses

Available options: success, error

Example:

"success"

data · object[] · required

Booking References

Show child attributes