Get
List Bookings
Deprecated
This method has been deprecated, and will be replaced in the future.
Deprecation Notice:
This endpoint has been replaced with Bookings V2 Query Extended Bookings and will be removed on December 31, 2024.
Retrieves a list of bookings according to the provided filters and paging. By default, only confirmed bookings are returned. Query object support:
- filter: supports
bookingId
- query for a specific booking. Example:"filter { string_value: "{ "bookingId": "46ce4cd4-46ff-4aa7-9cc0-02fd4f0f3209" }" }"
.contactId
- Bookings made by this contactId (defined in Contact service). Example:"filter { string_value: "{ "contactId": "b68960d3-820a-4588-a6b3-d7238add8af5" }" }"
.sessionId
- Bookings made to this sessionId. Support for a list of sessionIds; Example:"filter { string_value: "{ "sessionId": ["193ZPR9ppP9emJUCLevcLf6orynNE45", "193ZPR9ppP9emJUCLevcLf6orynNE98"] }" }"
.scheduleId
- Bookings made to sessions from this scheduleId, or made to the scheduleId itself. We support list of scheduleIds; Example:"filter { string_value: "{ "scheduleId": ["cd65b7de-164c-471b-908d-ee94d8ba6459", "fa573e37-e035-4bec-93b8-05cb90fe7aba"] }" }"
.startTime
- Bookings with booked entity (schedule/session) start time (UTC). We support 'gte' , 'lt'; Examples:- All bookings that will start after or equal to
27/04/20 10:00:00
-"filter { string_value: "{ "startTime": {"$gte": "2020-04-27T10:00:00.000Z" }}" }"
. - All bookings that start before
27/04/20 10:00:00
-"filter { string_value: "{ "startTime": {"$lt": "2020-04-27T10:00:00.000Z" }}" }"
. endTime
- Bookings with booked entity (schedule/session) end time (UTC). We support 'gt' , 'lte'; Examples:- All bookings that will start after
27/04/20 10:00:00
-"filter { string_value: "{ "startTime": {"$gt": "2020-04-27T10:00:00.000Z" }}" }"
. - All bookings that start before or equal to
27/04/20 10:00:00
-"filter { string_value: "{ "startTime": {"$lte": "2020-04-27T10:00:00.000Z" }}" }"
. status
- Bookings with this status. We support list of statuses. Example: "filter { string_value: "{ "status": ["CONFIRMED", "PENDING"] }" }".created
- Bookings creation time (UTC). We support 'gte' , 'lt'; Examples:- All bookings that were created after or equal to
27/04/20 10:00:00
-"filter { string_value: "{ "created": {"$gte": "2020-04-27T10:00:00.000Z" }}" }"
. - All bookings that were created before
27/04/20 10:00:00
-"filter { string_value: "{ "created": {"$lt": "2020-04-27T10:00:00.000Z" }}" }"
. - paging: Supported. Limit Example: "query { paging { limit { value: 10 } } }". Offset Example: "query { paging { offset { value: 10 } } }".
- fieldsets: not supported.
- fields: not supported.
Note:
- Only one use at a time of each filter once in the same query is supported. If a filter will be used more than once in one query, only the first occurrence is taken. Calling List without any filter, will return all bookings permitted to watch by the invoker permission.
- All results are for one specific business, resolved from the request context.
- A member should only be able to see their own bookings;
- To get the available actions for a member for each booking, based on the business bookings policy, use the
withBookingAllowedActions
field.
Permissions This endpoint requires the Read Bookings - Including Participants permission scope.
Endpoint
GET
https://www.wixapis.com/bookings/v1/bookingsWas this helpful?
Yes
No