Appointments

Get Available Slots

The bookable times for an event type, grouped by date under slots.

The AUTHENTICATED slots read - the unauthenticated one a prospect's browser calls is deliberately not published (see the module docstring).

get/appointments/slots

Request

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

Query parameters

event_type_idinteger required

Event type to compute slots for.

startstring required

Window start, ISO-8601. A bare date is read as UTC.

endstring required

Window end, ISO-8601. At most 60 days after start.

time_zonestring nullable

IANA timezone to express the slots in.

durationinteger nullable

Minutes, for a multi-duration event type. Omit for its own length.

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