About the Bookings APIs

The Bookings APIs let you schedule and manage service bookings for a business. Use them to retrieve booking details, manage the booking lifecycle, and track attendance.

• Bookings Reader V2 API: Retrieve bookings, including customer details, session data, attendance, and cancellation or rescheduling options.
• Bookings Writer V2 API: Create bookings and manage their lifecycle.
• Attendance API: Track and manage attendance for booking sessions.
• Bookings Validation Service Plugin: Add custom validation logic to booking operations.

Before you begin

You can handle checkout and payment flows with the eCommerce Checkout and eCommerce Orders APIs or use your own custom flow.

Booking lifecycle

Bookings progress through the following statuses:

Status	Description
CREATED	Initial booking created. Customer hasn't completed payment. Doesn't appear on the Booking Calendar or block availability.
PENDING	Awaiting manual business confirmation. Doesn't block availability.
CONFIRMED	Active booking. Appears on the Booking Calendar and blocks resource availability.
WAITING_LIST	Placed on a waitlist when a class session is at capacity. Available for class bookings only.
CANCELED	Canceled by the customer. May involve fees or refunds.
DECLINED	Rejected by the business before customer payment.

Common flows:

• Automatic approval: CREATED → CONFIRMED
• Manual approval: CREATED → PENDING → CONFIRMED or DECLINED
• Waitlist: CREATED → WAITING_LIST → CONFIRMED or DECLINED
• Cancellation: Any active status → CANCELED

Use cases

• Book an appointment
• Book a class session
• Book a course
• Reach out to customers who recently canceled
• Enforce limits or validate against an external system

Terminology

• Booking: A customer's reservation for a specific service, time slot, or schedule.
• Extended booking: A booking with additional details, such as attendance and whether the customer can cancel or reschedule.
• Multi-service booking: A package that combines multiple bookings under a single ID, scheduled sequentially. All included bookings are managed together.
• Session: An individual occurrence of a class or course.
• Schedule: A schedule in the Calendar APIs that represents availability or session timing. For appointments, a schedule defines when a staff member is available to take bookings. For classes and courses, a schedule defines when sessions occur. See Calendar Integration for how Wix Bookings uses schedules.

For a full glossary, see Terminology.