Orders

Reserve an order's resources

Place a short-lived hold on the underlying resources for every booking item in the order — practitioners, rooms, equipment, areas — so that another caller can't grab the same slot while the order is being finalised. Reservations are cooperative: they block other bookings only when the system explicitly checks (via the availability service), and they expire automatically after reserve_mins minutes.

Pass reserve_mins to override the site's default hold time; omit it to use the default. The value must be greater than zero.

Returns 400 Bad Request when one or more items can no longer be held (the underlying availability has slipped since the order was built).

post/shop/orders/{orderId}/reserve

Request body

reserve_minsinteger

How long the underlying resources should be reserved for, in minutes. Must be greater than zero. If omitted, the site's default hold time is used. Reservations are cooperative — they prevent another caller from booking the same slot while the order is being finalised, but expire automatically once the window elapses.

Example request

{
  "reserve_mins": 15
}

Response

The Order was successfully retrieved

Changes

No recorded changes to this endpoint across all 1 revision of this API.