Menu

Get a restaurant's full menu with optional search and filtering. Item IDs from this response are used to add items to the cart and in the select endpoint.

Get Restaurant Menu

GET /ret11/api/restaurants/{providerId}/seller/{sellerId}/foods
Public Endpoint

Authentication is not required for this endpoint. No Bearer token needed.

Path Parameters

ParameterTypeRequiredDescription
providerIdstringrequiredProvider ID from nearby-restaurants
sellerIdstringrequiredSeller UUID from nearby-restaurants

Query Parameters

ParameterTypeRequiredDescription
searchQuerystringoptionalSearch term to filter items by name or description. Example: pizza
vegFilterstringoptionalFilter by diet type. Accepted values: veg or nonveg
categoryIdsstringoptionalComma-separated category IDs from the categories endpoint. Example: CM11
GET /ret11/api/restaurants/pramaan_provider_1/seller/019b78d7-1371-7017-a997-3f6429a2f663/foods?searchQuery=pizza&vegFilter=veg&categoryIds=CM11

Response

Returns an object with provider information and menu items grouped by category.

provider

FieldTypeDescription
idstringProvider ID
namestringRestaurant display name
shortDescstringShort description of the restaurant
imagesstring[]Array of restaurant image URLs
locationobjectLocation object with id (locationId) and address
location.idstringLocation ID (e.g., SSL1)
location.address.localitystringLocality or neighborhood name
location.address.streetstringStreet address
location.address.citystringCity name
location.address.areaCodestringPIN / postal code
location.address.statestringState name

categories[]

Array of category objects. Each category groups related food items.

FieldTypeDescription
categoryIdstringCategory identifier (e.g., CM11)
categoryNamestringCategory display name (e.g., "Pizza")
categoryShortDescstringShort description of the category
categoryDisplaySeqnumberDisplay order sequence
items[]arrayFood items in this category — see items[] below

items[]

Each item in a category represents a food product that can be added to cart.

FieldTypeDescription
idstringItem ID. Used in cart/add and select endpoints.
namestringItem name
shortDescstringShort description
longDescstringFull description
imagesstring[]Array of item image URLs
ratingstringItem rating
unitstringUnit of measure (e.g., "piece")
unitValuestringValue per unit
maxOrdernumberMaximum quantity allowed per order
minPricenumberLowest possible price across all customization combinations
maxPricenumberHighest possible price across all customization combinations
defaultMinnumberPrice with default customizations selected (lower bound)
defaultMaxnumberPrice with default customizations selected (upper bound)
isCustomizablebooleanWhether the item has customization options
vegOrNonvegstring"veg" or "nonveg"
customizationGroups[]arrayHierarchical customization groups. Only present when isCustomizable is true. See customizationGroups[].

customizationGroups[]

Customizations are hierarchical. A pizza item may have: Crust (required, pick 1) → Size (required, pick 1) → Toppings (optional, up to 2). Each group on an item is a top-level group; nested groups appear under each option's childGroups.

FieldTypeDescription
idstringGroup ID (e.g., CG11). Used as parentCategoryId in cart.
namestringGroup label shown in UI (e.g., "Crust (any 1 option)")
typestringGroup type identifier
displaySeqnumberDisplay order within the item
minnumberMinimum selections required. 0 = optional, 1+ = required.
maxnumberMaximum number of selections allowed
inputstringUI input hint (e.g., "select")
items[]arraySelectable options within this group — see option fields below
items[].idstringOption ID. Used as item ID when adding customization selections to cart.
items[].namestringOption display name (e.g., "New Hand Tossed")
items[].pricenumberAdditional price for this option. 0 = no extra charge.
items[].maxPricenumberMaximum price for this option
items[].availablebooleanWhether the option is currently available
items[].isDefaultbooleanWhether this option is pre-selected by default
items[].childGroups[]arrayNested customization groups unlocked by selecting this option (e.g., Size inside a Crust choice). Same structure as customizationGroups[].
Customization IDs in Cart

When adding a customizable item to cart or the select endpoint, include the id of each selected customization option. Set parentCategoryId to the customization group ID (e.g., CG11), not the option ID itself.

{
  "provider": {
    "id": "pramaan_provider_1",
    "name": "Pramaan Store 1",
    "shortDesc": "Pramaan Store 1",
    "images": ["https://example.com/images/store1.webp"],
    "location": {
      "id": "SSL1",
      "address": {
        "locality": "N. Caldwell",
        "street": "633 Stagtrail Rd",
        "city": "New Delhi",
        "areaCode": "110030",
        "state": "Delhi"
      }
    }
  },
  "categories": [
    {
      "categoryId": "CM11",
      "categoryName": "Pizza",
      "categoryShortDesc": "Veg and Non-Veg Pizza",
      "categoryDisplaySeq": 1,
      "items": [
        {
          "id": "id_ancc5_0_0",
          "name": "Farmhouse Pizza",
          "shortDesc": "A classic loaded with farm fresh veggies",
          "longDesc": "Loaded with capsicum, mushroom, tomato and onion on a rich tomato sauce base.",
          "images": ["https://example.com/images/farmhouse.webp"],
          "rating": "4.5",
          "unit": "piece",
          "unitValue": "1",
          "maxOrder": 10,
          "minPrice": 265,
          "maxPrice": 999,
          "defaultMin": 265,
          "defaultMax": 399,
          "isCustomizable": true,
          "vegOrNonveg": "veg",
          "customizationGroups": [
            {
              "id": "CG11",
              "name": "Crust (any 1 option)",
              "type": "INS",
              "displaySeq": 1,
              "min": 1,
              "max": 1,
              "input": "select",
              "items": [
                {
                  "id": "id_1bai73_1_0",
                  "name": "New Hand Tossed",
                  "price": 0,
                  "maxPrice": 0,
                  "available": true,
                  "isDefault": true,
                  "childGroups": [
                    {
                      "id": "CG21",
                      "name": "Size (any 1 option)",
                      "type": "INS",
                      "displaySeq": 1,
                      "min": 1,
                      "max": 1,
                      "input": "select",
                      "items": [
                        { "id": "id_c2egb_3_0",    "name": "Regular", "price": 0,  "maxPrice": 0,  "available": true, "isDefault": true  },
                        { "id": "id_18yq4w_4_0",   "name": "Medium",  "price": 25, "maxPrice": 25, "available": true, "isDefault": false },
                        { "id": "id_55vxa_5_0",    "name": "Large",   "price": 50, "maxPrice": 50, "available": true, "isDefault": false }
                      ]
                    }
                  ]
                },
                {
                  "id": "id_newyo_1_1",
                  "name": "Wheat Thin Crust",
                  "price": 0,
                  "maxPrice": 0,
                  "available": true,
                  "isDefault": false,
                  "childGroups": []
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Usage Notes

Tip

When rendering a customizable item, show only top-level customizationGroups first. Load childGroups dynamically as the user makes selections to build a guided customization flow.