List appointments (meetings)Link to List appointments (meetings)
GET/appointments
Includes the calendar meeting link (googleMeetLink) and the call that booked it (callId).
- Scope
appointments:read
Query parameters
pagenumber- Default: 1
limitnumber- Default: 20 · Max 100
updatedSincestring- ISO 8601: only records changed at or after this instant. With sort=updatedAt&order=asc this is an incremental sync cursor
orderstring- One of: asc, desc · Default: desc
statusstringagentIdstringincludeCancelledboolean- Also return cancelled (soft-deleted) appointments, e.g. for a full syncDefault: false
sortstring- One of: scheduledAt, createdAt, updatedAt · Default: scheduledAt
fromstring- ISO date, filters scheduledAt >=
tostring- ISO date, filters scheduledAt <=
curl "https://bookifycall.com/api/v1/external/appointments" \
-H "X-API-Key: $BOOKIFYCALL_API_KEY"{
"success": true,
"data": [
{
"id": "00000000-0000-4000-8000-000000000004",
"organizationId": "00000000-0000-4000-8000-000000000100",
"leadId": "00000000-0000-4000-8000-000000000003",
"agentId": "00000000-0000-4000-8000-000000000002",
"clientName": "Jane Doe",
"clientEmail": "jane@example.com",
"clientCompany": "Example Dental",
"meetingPurpose": "Product demo",
"scheduledAt": "2026-01-20T15:00:00.000Z",
"endAt": "2026-01-20T15:30:00.000Z",
"timezone": "America/New_York",
"durationMin": 30,
"status": "scheduled",
"googleEventId": "example-event-id",
"googleMeetLink": "https://meet.google.com/abc-defg-hij",
"confirmed": true,
"notes": "Booked on a call [call:00000000-0000-4000-8000-000000000001]",
"createdAt": "2026-01-15T16:34:10.000Z",
"updatedAt": "2026-01-15T16:34:10.000Z",
"deletedAt": null,
"lead": {
"id": "00000000-0000-4000-8000-000000000003",
"name": "Jane Doe",
"email": "jane@example.com",
"company": "Example Dental"
},
"callId": "00000000-0000-4000-8000-000000000001"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 31,
"pages": 2
}
}