GET /Bookings/schedule - NowBookIt API

Get available booking time slots for a given date and party size. Optionally pass an existing booking ID to find alternative times for rescheduling.

X-API-KEY

string

required

Your API key

BookingDateTimeStart

string

required

Start of date range. Format: yyyy-MM-ddTHH:mm:ss.fffZ

NumOfPeople

integer

required

Number of guests

BookingDateTimeEnd

string

End of date range. If not provided, returns slots for the entire day.

BookingId

string

Existing booking ID to find alternative slots for rescheduling.

curl --location '[BASE_URL]/Bookings/schedule?BookingDateTimeStart=2024-03-20T00:00:00.000Z&NumOfPeople=4' \
--header 'X-API-KEY: your_api_key_here'

Response is an array of ScheduleQueryResponse objects. ScheduleQueryResponse

Field	Type	Nullable	Description
`isVenueOpen`	boolean	No	Whether the venue is open
`blockoutMessage`	string	Yes	Why venue is blocked out. Present when `isVenueOpen` is false
`services`	array of ServiceModel	Yes	Available services with time slots

ServiceModel

Field	Type	Nullable	Description
`id`	string	Yes	Service identifier
`name`	string	Yes	Service name
`online`	boolean	No	Accepts online bookings
`duration`	integer	No	Default duration in minutes
`description`	string	Yes	Service description
`serviceType`	string	Yes	Type (e.g. `dining`)
`policyAgreement`	string	Yes	Policy title shown at booking
`policyAgreementText`	string	Yes	Full policy text
`sections`	array of SectionModel	Yes	Available venue sections
`times`	array of TimeModel	Yes	Available time slots
`paymentDetails`	ServicePayment	No	Payment configuration

SectionModel — id (string), name (string), order (integer) TimeModel — time (string UTC datetime), name (string, e.g. “6:00 PM”), expired (boolean), bookingOptionsCount (integer), sections (array of { id, sectionState: boolean }) ServicePayment — paymentType, peopleRequired, price, fee, optionsFrom, optionsTo, maxPeoplePerBookingOverride, hasPromotion, singleMenuPerBooking Example 200 Response

[
  {
    "isVenueOpen": true,
    "blockoutMessage": null,
    "services": [
      {
        "id": "svc-101",
        "name": "Dinner Service",
        "online": true,
        "duration": 90,
        "description": "Standard dinner bookings",
        "serviceType": "dining",
        "sections": [
          { "id": "sec-1", "name": "Main Floor", "order": 1 }
        ],
        "times": [
          {
            "name": "6:00 PM",
            "expired": false,
            "bookingOptionsCount": 3,
            "time": "2024-03-20T18:00:00Z",
            "sections": [{ "id": "sec-1", "sectionState": true }]
          }
        ],
        "paymentDetails": {
          "paymentType": "none",
          "peopleRequired": 0,
          "price": 0.00,
          "fee": 0.00,
          "hasPromotion": false,
          "singleMenuPerBooking": false
        }
      }
    ]
  }
]

Status	Description
`200`	Schedule returned
`400`	`loggedInAppId`
`400`	`No Venue Subscribed to your App.`
`400`	`requested Date is not in correct format '{DateTimeISO8601Format}'.`
`401`	X-API-KEY missing or invalid
`429`	Rate limit exceeded