Introduction
Agent API
Agent Tool API
Widget Settings API
Phone Number & Telephony API
- GETList Available Numbers
- POSTBuy Phone Number
- DELRelease Phone Number
- GETList Purchased Numbers
- POSTImport Phone Number
- GETList Imported Numbers
- GETGet Imported Number
- PUTUpdate Imported Number
- DELDelete Imported Number
- GETList Twilio Owned Numbers
- POSTAdd Twilio Number
- POSTCreate Telephony Type
- GETGet Selected Telephony
Campaign API
Contact API
Appointment API
Cal.com Integration API
RAG Knowledge Base API
Webhooks
Health API
curl "https://api.ravan.ai/api/v1/calcom/appointments/019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c?org_id=1268c1f0-19f3-47db-aefb-c16a7c3ace6e" \
-H "X-Api-Key: YOUR_API_KEY"
{
"success": true,
"message": "Appointment fetched successfully",
"data": {
"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"
}
}
Cal.com Integration API
Get Cal.com Appointment
Retrieve details of a single Cal.com appointment by its ID.
GET
/
api
/
v1
/
calcom
/
appointments
/
{id}
curl "https://api.ravan.ai/api/v1/calcom/appointments/019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c?org_id=1268c1f0-19f3-47db-aefb-c16a7c3ace6e" \
-H "X-Api-Key: YOUR_API_KEY"
{
"success": true,
"message": "Appointment fetched successfully",
"data": {
"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"
}
}
Authorizations
Your Agni API key. Find it in your support@ravan.ai under Settings → API Keys.
Path Parameters
The unique appointment ID to retrieve.
Query Parameters
UUID of your organization.
Response
Whether the request succeeded.
Human-readable status message.
The appointment record.
Show data
Show data
Internal appointment record ID.
Organization ID.
ID of the agent that handled this booking.
Cal.com unique booking identifier.
Full name of the attendee.
Email address of the attendee.
Phone number (E.164).
IANA timezone (e.g.
America/New_York).Appointment start time (ISO 8601).
Appointment end time (ISO 8601).
Duration in minutes.
Video meeting URL.
Booking status.
curl "https://api.ravan.ai/api/v1/calcom/appointments/019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c?org_id=1268c1f0-19f3-47db-aefb-c16a7c3ace6e" \
-H "X-Api-Key: YOUR_API_KEY"
{
"success": true,
"message": "Appointment fetched successfully",
"data": {
"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"
}
}
⌘I