List free, bookable slots for a location and appointment type
Computed from the same availability engine as the calendar and online booking, so a returned slot is one the practice would book. visibility=online (default) is the patient view: the location, appointment type and (if given) practitioner must be enabled for online booking, and every online-booking rule applies — minimum advance notice, months ahead, daily caps, online-only guides, clustering. visibility=all is the front-desk view: every open slot for practitioners who provide the service, subject only to physical capacity. Up to 50 slots are returned per day. Not to be confused with practitioner_availabilities, which are the raw working-hours records this is computed from. Book a slot with POST /appointments (start/end/practitioner_id; group_master_id for a group slot).
Authorizations
API key from Developers → API Keys, sent as Authorization: Bearer .
Query Parameters
Location to search
Appointment type to book
Limit to one practitioner (omit for any)
Range start in the clinic timezone, YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (default: start of today)
"2026-09-01"
Range end (inclusive; a date means the end of that day). Default 7 days from from; at most 31 days
"2026-09-07"
Patient (online) or front-desk (all) view
online, all Cap on slots returned per day
1 <= x <= 50When finding a new time for an existing appointment: its occupied time is treated as free for overlapping alternatives (its duration/columns are used), but its exact current start is not offered