Skip to main content
GET
Get bookable time slots for a scheduler
Compute the bookable time slots for a scheduler over a date range — exactly what a guest sees on the public booking page, through the same shared engine: live roster resolution, calendar free/busy + working hours, the min-booking-notice floor, and the existing-bookings buffer/overbooking screen against Aura’s own calls table. Semantics:
  • start_date/end_date are inclusive UTC calendar days; the range spans at most 31 days and must start today or later.
  • The window is additionally clamped to the link’s booking horizon (available_days_in_future).
  • Slot times are unix seconds (UTC); timezone is echoed back for client-side formatting only.
  • An empty roster or a fully-booked range returns slots: [] (200).
Expected failures are typed, never a bare 500:
  • 400 — invalid date range
  • 422 — the link’s configuration was rejected by the availability provider (e.g. a misconfigured grant or calendar)
  • 502 — the availability provider is degraded (5xx / timeout)

Path Parameters

id
string
required

Scheduler ID (UUID)

Example:

"550e8400-e29b-41d4-a716-446655440000"

Query Parameters

start_date
string
required

Inclusive start of the range (UTC day, today or later)

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-10"

end_date
string
required

Inclusive end of the range (UTC day). The range spans at most 31 days.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-17"

timezone
string

IANA timezone echoed back in the response for formatting. Defaults to the scheduler's timezone.

Example:

"Europe/Berlin"

Response

Successfully computed availability

data
object
required
success
enum<boolean>
required
Available options:
true