Skip to main content
GET
/
api
/
v1
/
calcom
/
appointments
/
{appointment_id}
Get Appointment
curl --request GET \
  --url https://api.ravan.ai/api/v1/calcom/appointments/{appointment_id} \
  --header 'Authorization: Bearer <token>'
{
  "success": <boolean>,
  "message": "Appointment retrieved",
  "data": {
    "appointment": {
      "id": "<string>",
      "organization_id": "<string>",
      "ghl_appointment_id": "<string>",
      "contact_id": "<string>",
      "agent_id": "<string>",
      "agent_name": "<string>",
      "contact_name": "<string>",
      "contact_email": "<string>",
      "contact_phone": "<string>",
      "appointment_time": "<string>",
      "end_time": "<string>",
      "status": "<string>"
    },
    "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>.

​
Path Parameters

​
appointment_id
string
required
The Cal.com booking UID for the appointment you want to fetch.

​
Query Parameters

​
org_id
string
Optional fallback organization ID. It is used only when the JWT claims do not already include the org context.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Returned appointment data.
{
  "success": <boolean>,
  "message": "Appointment retrieved",
  "data": {
    "appointment": {
      "id": "<string>",
      "organization_id": "<string>",
      "ghl_appointment_id": "<string>",
      "contact_id": "<string>",
      "agent_id": "<string>",
      "agent_name": "<string>",
      "contact_name": "<string>",
      "contact_email": "<string>",
      "contact_phone": "<string>",
      "appointment_time": "<string>",
      "end_time": "<string>",
      "status": "<string>"
    },
    "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": "UNAUTHORIZED"
}

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

{
  "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.

Path Parameters

​
appointment_id
string
required

Cal.com booking UID

Query Parameters

​
org_id
string

Fallback organization ID used only when not present in JWT claims

Response

Appointment retrieved

​
success
boolean
​
message
string
​
data
object
Example:
{
  "appointment": {
    "id": "<string>",
    "organization_id": "<string>",
    "ghl_appointment_id": "<string>",
    "contact_id": "<string>",
    "agent_id": "<string>",
    "agent_name": "<string>",
    "contact_name": "<string>",
    "contact_email": "<string>",
    "contact_phone": "<string>",
    "appointment_time": "<string>",
    "end_time": "<string>",
    "status": "<string>"
  },
  "org_id": "<string>",
  "agent_id": "<string>"
}