Skip to content

List the caller's bookings (paginated)

GET
/appointments/bookings

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.

Authorizations

Parameters

Query Parameters

status
Any of:
string

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

event_type_id
Any of:
integer

Only bookings for this event type.

after_start
Any of:
string

ISO-8601 lower bound on start_time.

before_end
Any of:
string

ISO-8601 upper bound on end_time.

attendee_email
Any of:
string

Filter by an attendee email.

sort_by

Start_time | end_time | created_at | status.

string
default: start_time

Start_time | end_time | created_at | status.

sort_order
string
default: desc /^(asc|desc)$/
skip
integer
take
integer
default: 20 >= 1 <= 100

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string