Appointments

List Calendar Events

What is already on the connected Google / Outlook calendars in a window.

This is what makes a slot unavailable, so it is the read to reach for when availability looks wrong. READ-ONLY and display-only: private events come back as "Busy" blocks, and a calendar that fails to load is reported in errors rather than failing the request.

get/appointments/calendars/events

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/appointments/calendars/events
  • Auth: HTTP bearer

Query parameters

startstring date-time required

Window start, ISO-8601.

endstring date-time required

Window end, ISO-8601.

scope'my' | 'org'

my for the key owner alone, org for every member who has not opted out. An empty org result means nobody shares a calendar, not that nobody is busy.

host_emailsstring nullable

CSV. Narrows org scope to these members.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.