v1

latestOpenAPI 3.1.02026-07-2422707.0 MB

Reserve a slot for a service booking

This API helps you to reserve a slot for the specified service booking (booking_id).You can also use this API to reserve a slot for the required group service booking (booking_id).You can choose a specific therapist or a therapist based on a certain gender while creating a service booking; after which, a unique 32-digit booking_id is generated.You must then specify the generated booking_id in the API request. You can also provide appropriate details for the slot_time parameter in the API request body to reserve a slot for the service booking.After you have reserved a slot for the service booking, you can then proceed to confirm the service booking.This API also allows guests to reserve appointments for family members. Provided, there is a relationship defined in Zenoti and an appointment reservation can only be done by the host. Note: Invoice id is not generated in this step by default, It is generated only when you confirm a reservation with confirm a service booking API call. you can generate an temporary invoice in reserve slot API by using the create_invoice flag in the request body.

post/v1/bookings/{booking_id}/slots/reserve

Path parameters

booking_idstring required

Mandatory Unique 32-character identifier of the service booking.

Request body

slot_timestring date

date time of the slot

notesstring

Takes invoice notes

create_invoiceboolean

Parameter to define if invoice is to be created or not, default is false. Pass true if you need an invoice.

Response

200

is_reservedboolean

reservation_idstring

expiry_timestring

blocking_timeinteger

{"stackTrail":"paths:/v1/bookings/{booking_id}/slots/reserve:post:responses:200:content:application/json:schema:properties:error","oasType":"schema","type":"unknown"}

Example response

{
  "is_reserved": true,
  "reservation_id": "5ea5439b-5f0e-4dbb-8c3c-114e44248b35",
  "expiry_time": "2025-01-07T16:46:50",
  "blocking_time": 5,
  "invoices": [
    {
      "guest": {
        "Id": "d08f2de1-52bf-42fa-93ff-cc3a49ef9b66",
        "FirstName": "Surya Owner",
        "LastName": "A"
      },
      "invoice_id": "5b1158b9-09bc-4089-be2d-8c9a96f576b4",
      "items": [
        {
          "item": {
            "id": "fb64ce94-716e-49c5-98bc-8020b1c20fcb",
            "name": "Aroma Manicure"
          },
          "quantity": 1,
          "therapist": {
            "id": "955d352f-b8f1-4737-82ad-bd2af7129236",
            "full_name": "Ajay Kumar Singh",
            "first_name": "Ajay",
            "last_name": "Kumar Singh"
          },
          "start_time": "2025-01-07T17:30:00",
          "end_time": "2025-01-07T18:00:00",
          "invoice_item_id": "8393901a-9dfa-41d2-b3c9-598bd8ad37dc",
          "appointment_id": "451e64d2-d28a-4ad7-8b16-68db9662804f"
        }
      ]
    }
  ]
}