> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: About the Bookings APIs

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/introduction.md

## Article Content:

# 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](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-reader-v2/introduction.md): Retrieve bookings, including customer details, session data, attendance, and cancellation or rescheduling options.
- [Bookings Writer V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/introduction.md): Create bookings and manage their lifecycle.
- [Attendance API](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/attendance/introduction.md): Track and manage attendance for booking sessions.
- [Bookings Validation Service Plugin](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-validation-service-plugin/introduction.md): Add custom validation logic to booking operations.

## Before you begin

You can handle checkout and payment flows with the [eCommerce Checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout/checkout/introduction.md) and [eCommerce Orders](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/introduction.md) 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/flow-single-service-booking.md)
- [Book a class session](https://dev.wix.com/docs/api-reference/business-solutions/bookings/flow-single-service-booking.md)
- [Book a course](https://dev.wix.com/docs/api-reference/business-solutions/bookings/flow-single-service-booking.md)
- [Reach out to customers who recently canceled](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-reader-v2/sample-flows.md#reach-out-to-customers-who-have-recently-canceled)
- [Enforce limits or validate against an external system](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-validation-service-plugin/sample-flows.md#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](https://dev.wix.com/docs/api-reference/business-management/calendar/schedules-v3/introduction.md) 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/calendar-integration.md) for how Wix Bookings uses schedules.

For a full glossary, see [Terminology](https://dev.wix.com/docs/rest/business-solutions/bookings/terminology.md).