Use service booking APIs
The service booking APIs provide the endpoints for the booking lifecycle: creating bookings, retrieving available time slots, reserving and confirming slots, rescheduling, and cancelling. These are the core APIs used in the Book services using APIs workflow.
For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.
On this page
- Before you begin
- Create a service booking
- Retrieve available slots
- Reserve a slot
- Confirm a booking
- Reschedule a booking
- Cancel a booking
- Related articles
Before you begin
- You need a valid API key or access token. See Set up API authentication.
- Services, employee schedules, and center hours must be configured before creating bookings.
Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.
Create a service booking
POST /v1/bookings
Creates a service booking request. Supports single and group bookings, therapist preferences, and family member appointments.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| date | date | Yes | Booking date |
| guests | object | Yes | Guest and service details |
| guests.id | guid | Yes | Guest identifier |
| guests.items | array | Yes | Service and therapist selections |
| guests.items[].item_id | guid | Yes | Service identifier |
| guests.items[].therapist | object | No | Therapist preference (Id, Gender: 0=Any, 1=Male, 2=Female, 3=Specific) |
| guests.items[].room | object | No | Room selection (id) |
| guests.items[].add_ons | array | No | Add-on service items |
| is_family_booking | boolean | No | Whether this is a family member booking |
| host_id | guid | No | Host guest ID for group bookings |
Response: id (the booking ID, a 32-character GUID).
Retrieve available slots
GET /v1/bookings/{booking_id}/slots
Retrieves available time slots for a booking. If no slots are available on the requested day, returns the next available slot within the week.
| Parameter | Type | Required | Description |
|---|---|---|---|
| booking_id | guid | Yes | Booking identifier from the create step |
Response: slots (array with Time, Available, SalePrice, Priority, Warnings), future_days (availability on upcoming days), next_available_day.
Reserve a slot
POST /v1/bookings/{booking_id}/slots/reserve
Reserves a selected time slot for the booking. The reservation has an expiry time, after which the slot becomes available again.
| Parameter | Type | Required | Description |
|---|---|---|---|
| booking_id | guid | Yes | Booking identifier |
| slot_time | datetime | Yes | The time slot to reserve |
| create_invoice | boolean | No | Generate a temporary invoice during reservation (default: false) |
Response: is_reserved, reservation_id, expiry_time, blocking_time, invoices (guest details, invoice_id, appointment items with therapist, room, equipment, start and end times).
Confirm a booking
POST /v1/bookings/{booking_id}/slots/confirm
Confirms a reserved booking, finalizing the appointment.
| Parameter | Type | Required | Description |
|---|---|---|---|
| booking_id | guid | Yes | Booking identifier |
| notes | string | No | Guest notes |
| group_name | string | No | Name for group appointments |
Response: is_confirmed, invoice (with guest, invoice_id, and items containing service, therapist, room, equipment, timing, and appointment IDs).
Reschedule a booking
Rescheduling is a multi-step process:
- Create a new booking with the
invoice_idandinvoice_item_idfrom the original confirmed booking. - Retrieve available slots using the new booking ID.
- Reserve a slot.
- Confirm the rescheduled booking.
POST /v1/bookings
Include the original invoice_id and invoice_item_id in the request body along with the new booking details.
Cancel a booking
PUT /v1/invoices/{invoice_id}/cancel
Cancels a booking by removing all appointments and purchases linked to the invoice. If cancellation charges are configured, they are applied automatically.
| Parameter | Type | Required | Description |
|---|---|---|---|
| invoice_id | string | Yes | Invoice identifier for the booking |
Response: success, is_charge_applied (whether a cancellation fee was assessed).
Note: If payments have already been applied to the invoice, they must be removed before cancellation.