Fetch all events

Returns a paginated list of events for the specified business. Results can be filtered by status, cancellation, date range, and text search.

Cancelled bookings are excluded by default. Cancellation is tracked separately from status -- a cancelled booking keeps the status it had when it was cancelled -- so it is filtered with canceled_status, not event_status. Pass canceled_status=show_canceled_only to list only cancelled bookings, or canceled_status=show_all to include them alongside everything else. The two filters combine: event_status=confirmed&canceled_status=show_canceled_only returns cancelled confirmed bookings.

The response includes meta.total_count (total matching events) and meta.per_page (results per page) to support pagination.

Syncing changes. Pass updated_since to fetch only events changed since your last sync, including changes to booking questions and questionnaire answers. Send a full ISO 8601 timestamp with an offset, such as 2026-10-12T15:00:00Z; a bare date means noon. Start each sync from the time your previous one began, less a minute, since changes take a few seconds to become searchable. Each event's updated_at shows when it last changed.

Use the include query parameter to sideload related resources (comma-separated). Available: event_bookings, proposal_alternatives, event_users, event_staff_members, event_staff_requests, contacts, notes, event_adjustments. The event's customers are sideloaded via event_users — there is no customer include.

On a proposal with alternatives, starting_balance, deposit_amount_due and balance_amount_due add every alternative together, which is not a price the client pays. Read each alternative's totals instead.

Required permission: assigned_event_read or unassigned_event_read