calendars

List booked appointments

Returns appointments booked via calls or imported from connected calendars (Google, Outlook, Calendly, TidyCal, Square, Cal.com, GHL, Housecall Pro). 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.

get/calendars/appointments

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/calendars/appointments
  • Auth: HTTP bearer

Query parameters

pagenumber
limitnumber
period'upcoming' | 'past' | 'all'
agentIdstring
calendarIdstring
searchstring

Search by phone, email, or title

fromstring

Filter from date (ISO string)

tostring

Filter to date (ISO string)

Response

totalnumber required
pagenumber required
limitnumber required
totalPagesnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.