GET
/
api
/
v1
/
calcom
/
appointments
curl "https://api.ravan.ai/api/v1/calcom/appointments?limit=50" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Appointments fetched successfully",
  "data": {
    "appointments": [
      {
        "id": "019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c",
        "organization_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
        "agent_id": "019d1fdb-98e9-7c87-86c7-321e2fa98733",
        "calcom_booking_uid": "bk_abc123def456",
        "attendee_name": "Jane Doe",
        "attendee_email": "jane@example.com",
        "attendee_phone": "+14155550100",
        "attendee_timezone": "America/New_York",
        "start_time": "2026-03-25T14:00:00Z",
        "end_time": "2026-03-25T14:30:00Z",
        "duration_minutes": 30,
        "meeting_url": "https://meet.google.com/abc-defg-hij",
        "status": "accepted"
      }
    ],
    "count": 1
  }
}
Requires an active Cal.com connection. Use the Cal.com Status endpoint to verify your connection.

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key. Find it in your support@ravan.ai under Settings → API Keys.

​
Query Parameters

​
status
string
Filter by booking status (e.g. accepted, cancelled, pending).
​
agent_id
string
Filter appointments by agent ID.
​
limit
integer
Maximum number of appointments to return (max: 200).

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Appointment results.
curl "https://api.ravan.ai/api/v1/calcom/appointments?limit=50" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Appointments fetched successfully",
  "data": {
    "appointments": [
      {
        "id": "019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c",
        "organization_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
        "agent_id": "019d1fdb-98e9-7c87-86c7-321e2fa98733",
        "calcom_booking_uid": "bk_abc123def456",
        "attendee_name": "Jane Doe",
        "attendee_email": "jane@example.com",
        "attendee_phone": "+14155550100",
        "attendee_timezone": "America/New_York",
        "start_time": "2026-03-25T14:00:00Z",
        "end_time": "2026-03-25T14:30:00Z",
        "duration_minutes": 30,
        "meeting_url": "https://meet.google.com/abc-defg-hij",
        "status": "accepted"
      }
    ],
    "count": 1
  }
}

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
status
string

Filter by status

​
agent_id
string

Filter by agent ID

​
limit
integer<int32>
default:50

Number of results to return (max 200)

Required range: x <= 200

Response

Successful response

​
success
boolean
​
message
string
​
data
object