API reference · Tracking

Tracking data (public)

GET/v1/track/{token}

No key needed — the data behind the customer's tracking link. Shows the restaurant, status and delivery person; never the customer's phone.

No key needed
60 / minute per IP

Path parameters

tokenstringrequired: The last part of trackingUrl.

Request

curl https://api.billzova.com/v1/track/Vd3…

const t = await fetch(`https://api.billzova.com/v1/track/${token}`).then((r) => r.json());

Response

200 · application/json

{
  "object": "order", "test": false,
  "restaurant": { "name": "Desi Dera", "logo": null, "phone": "7234851000", "address": "…, Lucknow" },
  "redirectUrl": null,
  "order": { "number": "17", "status": "OUT_FOR_DELIVERY", "type": "DELIVERY", "items": [{ "name": "Chicken Biryani (Full)", "quantity": 1 }],
             "total": { "amount": 33600, "currency": "INR", "display": "₹336" }, "deliveryPerson": { "name": "Ramesh", "phone": "9811122233" } }
}

Good to know

If the restaurant set its own status page, redirectUrl points there.

Errors

Code	HTTP	Meaning
NOT_FOUND	404	Not found (or not visible to this key).
RATE_LIMITED	429	Too many requests — wait for `Retry-After` seconds.