Query Events V 2

Deprecation Notice

This endpoint has been replaced with Events V3's Query Events and will be removed on November 6, 2024. If your app uses this endpoint, we recommend updating your code as soon as possible.

Retrieves a list of up to 1,000 events, given the provided paging, filtering and sorting.

** Important **:

  • All results are for one specific business, resolved from the request context.

Query object support:

  • filter - supported, see filtering and sorting.
  • sort - supported, see filtering and sorting.
  • paging - supported, see paging.
  • fields - not supported.
  • fieldsets - not supported, use request-level fieldset instead.
  • cursorPaging - not supported, use offset pagination instead.


  • When filter is not specified, returns all events that caller is authorized to read.
  • When sorting is not specified, defaults to created in DESC order.

Permission Scopes

For app development, you must have one of the following permission scopes:
Read Events - all read permissions
Manage Bookings Services and Settings
Manage Events - all permissions
Read Events
Manage Guest List
Manage Events
Learn more about permission scopes.

Was this helpful?