Appointments

List Team Availability

Every teammate's availability windows for one day.

Cursor-paged on user id rather than offset, so a team that changes between pages does not shift rows under you. An empty date_ranges means that person has not set up a schedule, not that they are fully booked.

get/appointments/availability/team

Request

Base URL: https://be.graph8.com/api/v1
URL: https://be.graph8.com/api/v1/appointments/availability/team
Auth: HTTP bearer

Query parameters

datestring required

The day, YYYY-MM-DD.

viewer_tzstring

IANA timezone. INFORMATIONAL - the windows come back in UTC and the caller renders them; this shifts nothing server-side.

limitinteger

cursorinteger nullable

next_cursor from the previous page.

searchstring nullable

Name or email substring.

user_idsinteger[] nullable

Only these teammates. REPEATABLE (?user_ids=1&user_ids=2), and it takes PRECEDENCE over search - sending both ignores the search.

Headers

Authorizationstring nullable

X-Target-Org-Idstring nullable

Response

Successful Response

dataSchedulingPayload required

An open envelope for a filter, a setting, an embed config or a slot grid.

Open because org settings gain branding fields as the booking page does and the embed config gains styling keys as the widget does. Closing it would drop a field the app had already started returning.

Changes

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