Get Agent Cal.com Account
curl --request GET \
--url https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account', 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/agents/{agent_id}/account",
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/agents/{agent_id}/account"
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))
}HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
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": "Agent Cal.com account retrieved",
"data": {
"connected": <boolean>,
"type": "<string>",
"calcom_account_id": "<string>",
"account_name": "<string>",
"status": "<string>",
"api_base_url": "<string>"
}
}
Cal.com Integration API
Get Agent Cal.com Account
Returns the effective Cal.com account for an agent with priority: agent private key, then org-linked account, then none.
GET
/
api
/
v1
/
calcom
/
agents
/
{agent_id}
/
account
Get Agent Cal.com Account
curl --request GET \
--url https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account', 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/agents/{agent_id}/account",
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/agents/{agent_id}/account"
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))
}HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
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": "Agent Cal.com account retrieved",
"data": {
"connected": <boolean>,
"type": "<string>",
"calcom_account_id": "<string>",
"account_name": "<string>",
"status": "<string>",
"api_base_url": "<string>"
}
}
Authorizations
string
required
Your JWT access token. Pass it as a Bearer token in the
Authorization header. Example: Authorization: Bearer <token>.Path Parameters
string
required
The agent UUID whose effective Cal.com account you want to inspect.
Query Parameters
string
Optional fallback organization ID. It is used only when the JWT claims do not already include the org context.
Response
boolean
Whether the request succeeded.
string
Human-readable status message.
object
Effective Cal.com account information for the agent.
Show data
Show data
boolean
Whether the agent currently has an effective Cal.com account.
string
Source of the effective connection. Common values are
agent, org_linked, and none.string
Effective Cal.com account UUID when connected.
string
Effective Cal.com account name when connected.
string
Connection status when connected.
string
Effective Cal.com API base URL when connected.
{
"success": <boolean>,
"message": "Agent Cal.com account retrieved",
"data": {
"connected": <boolean>,
"type": "<string>",
"calcom_account_id": "<string>",
"account_name": "<string>",
"status": "<string>",
"api_base_url": "<string>"
}
}
{
"success": <boolean>,
"message": "Agent Cal.com account retrieved",
"data": {
"connected": false,
"type": "none"
}
}
{
"success": false,
"message": "<string>",
"code": "INVALID_REQUEST"
}
{
"success": false,
"message": "<string>"
}
{
"success": false,
"message": "<string>",
"code": "NOT_FOUND"
}
{
"success": false,
"message": "<string>",
"code": "INTERNAL_ERROR"
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Agent UUID
Query Parameters
Fallback organization ID used only when not present in JWT claims

