queryExtendedBookings( )

Retrieves a list of bookings, including additional extended information, given the provided paging, filtering, and sorting.

queryExtendedBookings() doesn't use a query builder, instead it uses API query language.

Up to 100 extended bookings can be returned per request.

queryExtendedBookings() runs with these defaults, which you can override:

  • createdDate sorted in DESC order
  • cursorPaging.limit is 50

You can retrieve information about which actions the customer can perform for the bookings. To do so, pass withBookingAllowedActions as true.

For field support, see supported filters for more information.

You can specify a filter only once per query. If you specify a filter more than once, only the first filter determines the extended bookings that are returned.

When filtering by date, you must use UTC time.

Authentication
  • When developing websites or building an app with Blocks, this method may require elevated permissions, depending on the identity of the user calling it and the calling user's permissions.
  • When building apps without Blocks or for headless projects, you can only call this method directly when authenticated as a Wix app or Wix user identity. When authenticated as a different identity, you can call this method using elevation.
  • Elevation permits users to call methods they typically cannot access. Therefore, you should only use it intentionally and securely.
Permissions
Manage Bookings - all permissions
Read Bookings - all read permissions
Manage Bookings
Read Bookings - Including Participants
Read bookings calendar - including participants
Learn more about app permissions.
Method Declaration
Copy
Method Parameters
queryCommonQueryV2Required

Information about filters, paging, and sorting.

optionsQueryExtendedBookingsOptions

Additional options for performing the query.

Returns
Return Type:Promise<QueryExtendedBookingsResponse>
Errors

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

Did this help?