---
title: "List Cal.com Appointments"
method: GET
path: "/api/v1/calcom/appointments"
tags: ["CalComService"]
---

# List Cal.com Appointments

`GET /api/v1/calcom/appointments`

## Query parameters

- `org_id` string, required
- `status` string
- `agent_id` string
- `limit` integer

## Response `200`

Appointments retrieved

- ListCalcomAppointmentsResponse
  - `success` boolean
  - `message` string
  - `data` ListCalcomAppointmentsData
    - `appointments` CalcomAppointment[]
      - `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

## Other responses

- `400` — Missing org_id, Cal.com not connected, API key missing, or Cal.com API failure
- `401` — Missing or invalid JWT
- `500` — Unexpected error

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/versions/48f45dc58534/schema)