API reference · Restaurant

Get the restaurant

GET/v1/restaurant

Name, contact, address, opening hours, whether it is open and accepting orders right now, and its ordering and booking settings.

Scope restaurant:read
600 / minute

Request

curl https://api.billzova.com/v1/restaurant \
  -H "Authorization: Bearer $BILLZOVA_KEY"

const res = await fetch('https://api.billzova.com/v1/restaurant', {
  headers: { Authorization: `Bearer ${process.env.BILLZOVA_KEY}` },
});
const restaurant = await res.json();

Response

200 · application/json

{
  "id": "4f1c…",
  "object": "restaurant", "test": false, "timezone": "Asia/Kolkata", "currency": "INR",
  "name": "Desi Dera",
  "phone": "7234851000",
  "address": { "line": "…", "city": "Lucknow", "state": "Uttar Pradesh", "pincode": "226010" },
  "gstin": null,
  "openingHours": { "days": { "mon": [{ "open": "11:00", "close": "23:00" }], "…": [] }, "closedDates": [] },
  "status": { "open": true, "label": "Open · closes 11:00 PM", "opensAt": null, "closesAt": "2026-10-24T17:30:00.000Z" },
  "ordering": {
    "enabled": true, "acceptingNow": true, "types": ["PICKUP", "DELIVERY"],
    "minimumOrder": { "amount": 0, "currency": "INR", "display": "₹0" }, "deliveryPincodes": ["226010"],
    "prepMinutes": 20, "paymentModes": ["PAY_AT_COUNTER", "CASH_ON_DELIVERY"]
  },
  "booking": { "enabled": true, "maxPeople": 10, "slotMinutes": 30, "daysAhead": 30, "price": null }
}

Good to know

ordering.acceptingNow is true only when online orders are on, the restaurant is open, and at least one staff device is online. Show "Not taking orders right now" when it is false.

Errors

Code	HTTP	Meaning
UNAUTHENTICATED	401	Missing or malformed API key. Send it as `Authorization: Bearer bz_live_sk_…`.
KEY_REVOKED	401	The key was revoked. Create a new key in the dashboard.
SCOPE_MISSING	403	The key is not allowed to do that.
RATE_LIMITED	429	Too many requests — wait for `Retry-After` seconds.