API reference · Reservations

Check availability

GET/v1/reservations/availability

Bookable time slots for a date and party size, from the restaurant's opening hours and how many guests are already booked. Includes the price if bookings are paid.

Scope reservations:read
600 / minute

Query parameters

dateYYYY-MM-DDrequired: Restaurant-local date.
peopleintegerrequired: Party size (up to the restaurant's maximum).

Request

curl "https://api.billzova.com/v1/reservations/availability?date=2026-10-24&people=4" \
  -H "Authorization: Bearer $BILLZOVA_KEY"

const av = await fetch('https://api.billzova.com/v1/reservations/availability?date=2026-10-24&people=4', {
  headers: { Authorization: `Bearer ${process.env.BILLZOVA_KEY}` },
}).then((r) => r.json());

Response

200 · application/json

{
  "object": "availability", "date": "2026-10-24", "people": 4,
  "price": { "amount": 20000, "currency": "INR", "display": "₹200", "mode": "DEDUCT" },
  "slots": [
    { "time": "19:00", "startsAt": "2026-10-24T13:30:00.000Z", "available": true, "price": { "amount": 20000, "currency": "INR", "display": "₹200" } },
    { "time": "19:30", "startsAt": "2026-10-24T14:00:00.000Z", "available": false, "price": { "amount": 20000, "currency": "INR", "display": "₹200" } }
  ]
}

Good to know

price.mode: DEDUCT — the amount is deducted from the final bill; FEE — a booking fee. price is null when bookings are free.

Errors

Code	HTTP	Meaning
BOOKINGS_OFF	403	Table booking is switched off.
PARTY_TOO_LARGE	422	More guests than an online booking allows.
RESTAURANT_UNAVAILABLE	403	The restaurant cannot take orders or bookings (subscription or account).
VALIDATION_FAILED	422	The body is invalid — `field` says where.