List bookings
List bookings of the native booking engine. Bookings are created by the public booking page, by assistants mid-call (book_appointment), or via the public page API — this management API is read + reschedule + cancel only. Use view for the dashboard-style lists, or status for an exact status; they cannot be combined.
Required scope: bookings:read (keys without scope restrictions have full access).
Authorizations
API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). REST operations also require API Access for the credential's workspace. Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, loop:read, loop:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access within the workspace's available capabilities.
Query Parameters
Filter by event type.
Filter by exact status. Cannot be combined with view.
confirmed, cancelled, completed, no_show Filter by booking source.
web, call, api Dashboard-style booking view. Cannot be combined with status.
upcoming, unconfirmed, recurring, past, cancelled Only bookings with start_at >= from.
Only bookings with start_at <= to.
x <= 200Response
Bookings (paginated; meta.pagination.total carries the total count).