# Billzova Developers

> Build restaurant websites and apps on Billzova: live menu, GST-correct quotes, online orders, table bookings and order tracking — straight into the restaurant's POS and reports. 0% commission.

Base URL: https://api.billzova.com/v1. Auth: `Authorization: Bearer bz_live_sk_…` (secret keys, server-side only). Money is integer paise plus a display string.

## Docs
- [Getting started](https://developers.billzova.com/docs/getting-started): Make your first request to the Billzova API in five minutes.
- [Authentication & keys](https://developers.billzova.com/docs/authentication): Secret keys, test mode, scopes, IP locks and revoking.
- [Errors](https://developers.billzova.com/docs/errors): One error format for every endpoint, stable codes you can branch on, and a request ID for support.
- [Idempotency (safe retries)](https://developers.billzova.com/docs/idempotency): Send an Idempotency-Key with every create, so a retried request never makes a second order or booking.
- [Rate limits](https://developers.billzova.com/docs/rate-limits): How much you can call, and what to do when you hit a limit.
- [Test mode](https://developers.billzova.com/docs/testing): Build against real prices without sending anything to the kitchen.
- [Versioning & compatibility](https://developers.billzova.com/docs/versioning): What will never change under you in v1, what may be added, and what your code must handle so it keeps working for years.
- [Website ordering, end to end](https://developers.billzova.com/docs/website-ordering): Menu → cart → quote → order → status → tracking, the way Billzova websites do it.
- [Table booking](https://developers.billzova.com/docs/table-booking): Show free times from the restaurant’s hours and capacity, then take table bookings, free or paid.
- [Tracking links](https://developers.billzova.com/docs/tracking): One status link for the customer, from accepted to out for delivery, branded as the restaurant.
- [Changelog](https://developers.billzova.com/docs/changelog): Every change to the Billzova API, newest first: new endpoints, new fields and anything you need to update.

## API reference
- [Get the restaurant](https://developers.billzova.com/reference/get-restaurant): `GET /v1/restaurant` — Name, contact, address, opening hours, whether it is open and accepting orders right now, and its ordering and booking settings.
- [Get the menu](https://developers.billzova.com/reference/get-menu): `GET /v1/menu` — The live menu exactly as the POS has it: categories, items, sizes, add-on groups, food type, GST and availability.
- [Quote an order](https://developers.billzova.com/reference/quote-order): `POST /v1/orders/quote` — Billzova prices the cart with the same engine the POS bills with: items, add-ons, GST split, total
- [Place an order](https://developers.billzova.com/reference/create-order): `POST /v1/orders` — Places the order into the restaurant's POS
- [Get an order](https://developers.billzova.com/reference/get-order): `GET /v1/orders/{id}` — Current status, timeline, totals and delivery person of an order placed with this key.
- [List orders](https://developers.billzova.com/reference/list-orders): `GET /v1/orders` — Orders placed with this key, newest first
- [Cancel an order](https://developers.billzova.com/reference/cancel-order): `POST /v1/orders/{id}/cancel` — The customer cancels — only while the restaurant has not accepted it yet.
- [Check availability](https://developers.billzova.com/reference/booking-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
- [Book a table](https://developers.billzova.com/reference/create-booking): `POST /v1/reservations` — Creates a booking
- [Get a booking](https://developers.billzova.com/reference/get-booking): `GET /v1/reservations/{id}` — Current status of a table booking made with this key: date, time, guests, price and whether the restaurant confirmed it.
- [Cancel a booking](https://developers.billzova.com/reference/cancel-booking): `POST /v1/reservations/{id}/cancel` — The customer cancels — up to the restaurant's cancellation cut-off before the time.
- [Tracking data (public)](https://developers.billzova.com/reference/track): `GET /v1/track/{token}` — No key needed — the data behind the customer's tracking link

## Optional
- [Error codes](https://developers.billzova.com/reference/errors)
- [Support](https://developers.billzova.com/support): info@billzova.com, WhatsApp +91-8869997605
- [Everything in one file](https://developers.billzova.com/llms-full.txt)