List booked appointments

GET

/calendars/appointments

Returns appointments booked via calls or imported from connected calendars (Google, Outlook, Calendly, Square, Cal.com, GHL). Supports pagination (1-indexed page, max 100 per page — different from the 0-indexed offset used by /calls), plus filters by period ('upcoming' | 'past' | 'all'), agentId, calendarId, and free-text search across phone/email/title. Appointments only appear if at least one calendar is connected and enabled.

Request

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/calendars/appointments?page=&limit=&period=&agentId=&calendarId=&search=&from=&to='

Response Example

{
    "appointments": [
        {
            "id": "string",
            "title": "string",
            "description": "string",
            "startTime": "2019-08-24T14:15:22.123Z",
            "endTime": "2019-08-24T14:15:22.123Z",
            "durationMinutes": 0,
            "guestPhone": "string",
            "guestEmail": "string",
            "guestName": "string",
            "sourceType": "INBOUND_CALL",
            "callId": "string",
            "isIncoming": true,
            "calendarProvider": "GOOGLE",
            "externalEventId": "string",
            "externalEventUrl": "string",
            "callDetailsUrl": "string",
            "agent": {
                "id": "string",
                "name": "string",
                "avatar": "string"
            },
            "calendar": {
                "id": "string",
                "name": "string",
                "provider": "GOOGLE"
            },
            "timezone": "string",
            "createdAt": "2019-08-24T14:15:22.123Z"
        }
    ],
    "total": 0,
    "page": 0,
    "limit": 0,
    "totalPages": 0
}

Modified at 2026-07-23 18:02:16

Update custom fields on a customer

Get upcoming appointments for widget