For developers

PITSTOP API

Show a restaurant's live menu on its own website or a TV screen, or pull its orders into accounting software. Everything is read-only: nothing here can change a menu or an order.

1. Get a key

The restaurant owner makes one on their PITSTOP dashboard, under Other apps → API keys, and picks what it can read (menu, orders). The key is shown once. Keep it on your server: a key that can read orders must never be put in a web page.

2. Call the API

curl -H "Authorization: Bearer ps_your_key_here" \
  https://<pitstop-address>/api/v1/menu

• GET /api/v1/restaurant

  Name, address, map location, hours, open now, and how it serves (dine-in, takeaway, delivery).

  Needs: menu

• GET /api/v1/menu

  Every dish by section: price, veg, photo, badges, sold out or not, and its sizes and add-ons.

  Needs: menu

• GET /api/v1/orders?since=…&limit=…

  Orders from a date onward, oldest first, with their items. No customer phone numbers. Follow `next` for more.

  Needs: orders

• GET /api/v1/restaurants?city=hisar

  Every live restaurant on PITSTOP. Add ?restaurant=<id or slug> to the calls above to pick one.

  Needs: platform keys only

What a menu looks like

{
  "restaurant": { "id": "…", "name": "Sharma Dhaba", "open_now": true,
                  "serves": { "dine_in": true, "takeaway": true, "delivery": false }, … },
  "sections": [
    { "name": "Main Course",
      "dishes": [
        { "id": "…", "name": "Kadai Paneer", "price": 240, "veg": true, "available": true,
          "image": "https://…/kadai-paneer.webp", "badges": ["bestseller"],
          "options": [
            { "group": "Portion", "required": true, "max": 1, "pricing": "size",
              "choices": [ { "id": "…", "name": "Half", "price": 150 },
                           { "id": "…", "name": "Full", "price": 240 } ] } ] } ] } ]
}

pricing is size when the choice's price is the dish's price (Half ₹150), or addwhen it's added on top (Extra cheese +₹30).

Rules

• 120 calls a minute per key. Menus change rarely: fetching every few minutes is plenty.
• Fields are only ever added within /api/v1, never renamed or removed.
• Errors come back as { "error": "…" } with a 4xx status that says what to fix.
• The owner can revoke a key at any time; calls with it then get 401.

ONDC

PITSTOP is also an ONDC seller app for food (ONDC:RET11). Buyer apps on the network reach it through the Beckn protocol, not this API.

Questions? hello@pitstop.dev