Skip to main content
Returns the open appointment slots for a single date. The slot length is based on the total duration of the services the customer selected (or the business’s default slot length if no services are passed).

Path parameters

string
required
Your booking page token (booking slug or lead token).

Query parameters

string
required
The date to check, in YYYY-MM-DD format (interpreted in the business’s timezone).
string
Optional comma-separated service IDs (e.g., 12,15). The total estimated duration of these services determines how long each slot must be. If omitted, the default slot duration is used.

Response

Returns 200 OK with the open slots.
array
An array of available slots. Each slot has a start and end timestamp (ISO 8601). An empty array means no availability that day — including dates outside the booking window (before today or beyond booking_advance_days).

Example

Use the start value of a chosen slot directly as the date field when you submit the booking.

Errors

A date outside the allowed booking window doesn’t return an error — it returns 200 OK with an empty slots array.

Get config

Back: fetch services and settings.

Submit booking

Next: create the order or lead.