Appointments

List the caller's bookings (paginated)

List bookings visible to the caller.

Personal keys retain the member-scoped path. An organization key that passed the existing explicit meetings:read gate uses the handler's org-wide read path and therefore never looks up the synthetic API identity.

get/appointments/bookings

Request

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

Query parameters

statusstring nullable

Filter by status: accepted | pending | cancelled | rejected.

event_type_idinteger nullable

Only bookings for this event type.

after_startstring nullable

ISO-8601 lower bound on start_time.

before_endstring nullable

ISO-8601 upper bound on end_time.

attendee_emailstring nullable

Filter by an attendee email.

sort_bystring

start_time | end_time | created_at | status.

sort_orderstring
skipinteger
takeinteger

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

object required

Changes

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