Booking Object


An entity representing a scheduled appointment, class session, or course.

Properties
idstringRead-onlyformat GUID

Booking ID.


bookedEntityBookedEntity

An object describing the slot (SDK | REST) or schedule (SDK | REST) that was booked.


contactDetailsContactDetails

Contact details of the site visitor or member (SDK | REST) making the booking.


additionalFieldsArray <CustomFormField>

Additional custom fields submitted with the booking form.


statusstring

Booking status. A booking is automatically confirmed if the service allows it and an eCommerce order is created. It is automatically declined if there is a double booking and the customer hasn't paid or is eligible for an automatic refund. Currently, only payments with pricing plans are automatically refundable.


paymentStatusstring

The payment status of the booking corresponds to the paymentStatus of the related eCommerce order (SDK| REST), if one exists. All payment statuses are supported for every booking status.


selectedPaymentOptionstring

Payment option selected by the customer. If the customer hasn't completed their checkout, they may still change the payment method. Must be one of the payment options offered by the service (SDK | REST), unless skipSelectedPaymentOptionValidation is true. When undefined during an eCommerce checkout (SDK | REST), Wix Bookings uses the service's default payment option


createdDatestringRead-onlyformat date-time

Date and time the booking was created in YYYY-MM-DDThh:mm:ss.sssZ format.


externalUserIdstring

External user ID that you can provide.


revisionintegerformat int64

Revision number to be used when updating, rescheduling, or cancelling the booking. Increments by 1 each time the booking is updated, rescheduled, or canceled. To prevent conflicting changes, the current revision must be specified when updating the booking.


createdByCreatedByRead-only

ID of the creator of the booking. If appId and another ID are present, the other ID takes precedence.


startDatestringRead-onlyformat date-time

The start date of the booking in YYYY-MM-DDThh:mm:ss.sssZ format. For a slot, this is the start date of the slot. For a schedule, this is the start date of the first session.


endDatestringRead-onlyformat date-time

The end date of the booking in YYYY-MM-DDThh:mm:ss.sssZ format. For a slot, this is the end date of the slot. For a schedule, this is the end date of the last session.


updatedDatestringRead-onlyformat date-time

Date and time the booking was updated in YYYY-MM-DDThh:mm:ss.sssZ format.


extendedFieldsExtendedFields

Custom field data for this object. Extended fields must be configured in the app dashboard before they can be accessed with API calls.


doubleBookedbooleanRead-only

Whether this booking overlaps with another confirmed booking. Returned only if set to true.


ONE OF:

totalParticipantsintegerminimum 1

Total number of participants. Available only when the relevant service doesn't have variants and options (SDK | REST).


participantsChoicesParticipantsChoices

Information about the booked service choices and participants. Available only when the booking includes multiple service variants (SDK | REST).

Did this help?