Skip to main content
GET
/
api
/
v1
/
calcom
/
appointments
List Cal.com Appointments
curl --request GET \
  --url https://api.ravan.ai/api/v1/calcom/appointments \
  --header 'Authorization: Bearer <token>'
{
  "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

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

​
Query Parameters

​
org_id
string
required
The organization ID whose primary Cal.com account bookings you want to fetch.
​
status
string
Optional Cal.com booking status filter.
​
agent_id
string
Optional agent ID that is stamped onto the results and echoed back in the response.
​
limit
integer
Optional result limit. Defaults to 50 and is clamped back to 50 when the value is <= 0 or > 200.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Returned appointment data.
{
  "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
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>"
}