List Cal.com Appointments

curl --request GET \
  --url https://api.ravan.ai/api/v1/calcom/appointments \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ravan.ai/api/v1/calcom/appointments', 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.ravan.ai/api/v1/calcom/appointments",
  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: Bearer <token>"
  ],
]);

$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.ravan.ai/api/v1/calcom/appointments"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/calcom/appointments")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": <boolean>,
  "message": "Appointments retrieved",
  "data": {
    "appointments": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "agent_id": "<string>",
        "attendee_name": "<string>",
        "attendee_email": "<string>",
        "attendee_phone": "<string>",
        "attendee_timezone": "<string>",
        "start_time": "<string>",
        "end_time": "<string>",
        "duration_minutes": <integer>,
        "status": "<string>"
      }
    ],
    "count": <integer>,
    "org_id": "<string>",
    "agent_id": "<string>"
  }
}

GET

api

calcom

appointments

List Cal.com Appointments

curl --request GET \
  --url https://api.ravan.ai/api/v1/calcom/appointments \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ravan.ai/api/v1/calcom/appointments', 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.ravan.ai/api/v1/calcom/appointments",
  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: Bearer <token>"
  ],
]);

$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.ravan.ai/api/v1/calcom/appointments"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/calcom/appointments")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": <boolean>,
  "message": "Appointments retrieved",
  "data": {
    "appointments": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "agent_id": "<string>",
        "attendee_name": "<string>",
        "attendee_email": "<string>",
        "attendee_phone": "<string>",
        "attendee_timezone": "<string>",
        "start_time": "<string>",
        "end_time": "<string>",
        "duration_minutes": <integer>,
        "status": "<string>"
      }
    ],
    "count": <integer>,
    "org_id": "<string>",
    "agent_id": "<string>"
  }
}

Authorizations

string

required

Your JWT access token. Pass it as a Bearer token in the Authorization header. Example: Authorization: Bearer <token>.

Query Parameters

string

required

The organization ID whose primary Cal.com account bookings you want to fetch.

string

Optional Cal.com booking status filter.

string

Optional agent ID that is stamped onto the results and echoed back in the response.

integer

Optional result limit. Defaults to 50 and is clamped back to 50 when the value is <= 0 or > 200.

Response

boolean

Whether the request succeeded.

string

Human-readable status message.

object

Returned appointment data.

Show data

array

Array of appointments fetched from Cal.com.

integer

Total number of returned appointments.

string

Echoed organization ID.

string

Echoed agent ID when provided.

{
  "success": <boolean>,
  "message": "Appointments retrieved",
  "data": {
    "appointments": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "agent_id": "<string>",
        "attendee_name": "<string>",
        "attendee_email": "<string>",
        "attendee_phone": "<string>",
        "attendee_timezone": "<string>",
        "start_time": "<string>",
        "end_time": "<string>",
        "duration_minutes": <integer>,
        "status": "<string>"
      }
    ],
    "count": <integer>,
    "org_id": "<string>",
    "agent_id": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "code": "INVALID_REQUEST"
}

{
  "success": false,
  "message": "<string>",
  "code": "NOT_CONNECTED"
}

{
  "success": false,
  "message": "<string>",
  "code": "CALCOM_API_ERROR"
}

{
  "success": false,
  "message": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "code": "INTERNAL_ERROR"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

org_id

string

required

Organization ID

status

string

Cal.com booking status filter

agent_id

string

Agent ID to stamp onto results and echo back

limit

integer

default:50

Result limit, clamped to 50 when <=0 or >200

Response

Appointments retrieved

success

boolean

message

string

data

object

Show child attributes

Example:

{
  "appointments": [
    {
      "id": "<string>",
      "organization_id": "<string>",
      "agent_id": "<string>",
      "attendee_name": "<string>",
      "attendee_email": "<string>",
      "attendee_phone": "<string>",
      "attendee_timezone": "<string>",
      "start_time": "<string>",
      "end_time": "<string>",
      "duration_minutes": 0,
      "status": "<string>"
    }
  ],
  "count": 1,
  "org_id": "<string>",
  "agent_id": "<string>"
}

Introduction

Agent API

Organization API

Agent Tool API

Phone Number & Telephony API

Campaign API

Contact API

Calling API

Appointment API

GHL Integration API

Cal.com Integration API

RAG Knowledge Base API

Webhooks

Health API

List Cal.com Appointments

Authorizations

Query Parameters

Response

Authorizations

Query Parameters

Response

​Authorizations

​Query Parameters

​Response

Authorizations

Query Parameters

Response

Authorizations

Query Parameters

Response