Sign in

v1

latestOpenAPI 3.0.12026-07-2691137122.3 KB
CalComService

List Cal.com Appointments

get/api/v1/calcom/appointments

Query parameters

org_idstring required

Organization ID

statusstring

Cal.com booking status filter

agent_idstring

Agent ID to stamp onto results and echo back

limitinteger

Result limit, clamped to 50 when <=0 or >200

Response

Appointments retrieved

successboolean
messagestring

Example response

{
  "success": true,
  "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": 0,
        "status": "<string>"
      }
    ],
    "count": 1,
    "org_id": "<string>",
    "agent_id": "<string>"
  }
}