find_booking_times

com.pinsvit/api · Verify this server

Finds the times a user can book at a place. Start here for any booking: only the place is required. The answer lists, per date, windows of bookable starts. To book, pick a start from a window's from up to and including its lastStart, a whole number of stepMinutes after from (no stepMinutes means any minute), then send that start, the answer's durationMinutes and one of the window's streamIds to create_booking. The earliest time is the first window's from. Windows hold for one booking length, the answer's durationMinutes: set it with serviceIds or durationMinutes, otherwise it is the place's shortest booking. For another length, search again rather than stretching a window. Arguments use the place's local clock; answers are UTC. The answer is advisory: create_booking checks again and names the nearest bookable starts when it refuses. Staff booking for a customer at their own place set forCustomer, so the answer matches the create_booking they will send: the place's minimum notice does not apply to it.