GET

List Events


Retrieves a list of events from all external calendar accounts, based on the provided filtering and paging.

Filters

You must filter by specifying both from and to dates, unless you specify cursorPaging.cursor.

Additionally, you can specify scheduleIds or userIds to further limit which events are returned. By default, events related to all schedules and Wix users are returned.

Sorting

Returned events are sorted by start date in ascending order. You can't adjust the sorting.

Personal data

By default, the following event fields aren't returned:

  • calendarName.
  • title.
  • scheduleOwnerName.

You can retrieve these fields, by specifying {"fieldsets": "OWN_PI"}.

Partial success

By default, the call fails if events for at least 1 connection can't be retrieved from an external provider. However, you can specify {"partialFailure": true} to allow the call to succeed, if details for at least 1 connection can be retrieved.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings - all permissions
Manage External Calendars
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/bookings/v2/external-calendars/events

Query Params
fromstring

Date and time from which to retrieve events, formatted according to RFC 3339. Required, unless cursorPaging.cursor is provided.

Events which start before the from time and end after it are included in the returned list.


tostring

Date and time until which to retrieve events, formatted according to RFC 3339. Required, unless cursorPaging.cursor is provided.

Events which start before the to time and end after it are included in the returned list.


scheduleIdsArray <string>

Schedule IDs to filter by. If provided, the returned list includes only events belonging to external calendars connected to the specified schedules. Maximum of 100 schedule IDs per request.


userIdsArray <string>

Wix user IDs to filter by. If provided, the returned list includes only events belonging to external calendars connected to schedules belonging to the specified Wix users. Maximum of 100 Wix user IDs per request.


allDayboolean

Whether to include only all-day events in the returned list. If true, only all-day events are returned. If false, only events with a specified time are returned.

Default: All events are returned.


fieldsetsArray <string>

Predefined sets of fields to return.

  • NO_PI: Returns event objects without personal information.
  • OWN_PI: Returns complete event objects, including personal information.

Default: NO_PI


cursorPaging.limitintegerminimum 0maximum 1000format int32

Number of events to load. Max: 1000


cursorPaging.cursorstring

Pointer to the next or previous page in the list of results.

You can get the relevant cursor token from the pagingMetadata object in the previous call's response. Not relevant for the first request.


partialFailureboolean

Whether to return a partial list of events if details can't be retrieved for some connections.

Default: false

Response Object
eventsArray <Event>

List of external calendar events matching the filters.


pagingMetadataPagingMetadata

Paging metadata.


failedProviderIdsArray <string>

List of provider IDs for connections for which retrieval of events failed. Returned only if partialFailure body parameter is true in the request.

Request
cURL
Response
JSON
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?