MercatDevelopers
  1. Menus
MercatDevelopers
  • Getting Started
  • Auth
    • Authenticate client
      POST
  • Stores
    • List all stores
      GET
    • Get store details
      GET
  • Menus
    • Get menu details
      GET
  • Orders
    • Get order details
      GET
  • Webhooks
    • Webhooks
    • stores.update
    • orders.create
    • orders.update
    • menus.update
  1. Menus

Get menu details

Stage
https://stage.api.mercat.com
Stage
https://stage.api.mercat.com
GET
/v1/mercat_developers/menus/{menu_id}
Returns the complete menu structure with normalized products and modifiers dictionaries.
Authentication required: Include the access token obtained from the Authenticate client endpoint.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Responses

🟢200OK
application/json
Menu details retrieved successfully
Body

Example
{
    "menu": {
        "id": 1,
        "name": "Main Menu",
        "price_groups": [
            {
                "id": 1,
                "name": "Pizzas",
                "position": 1,
                "prices": [
                    {
                        "price_id": 1,
                        "product_id": 1,
                        "position": 1,
                        "channel": "both",
                        "price": 10,
                        "delivery_price": 12
                    },
                    {
                        "price_id": 2,
                        "product_id": 2,
                        "position": 2,
                        "channel": "both",
                        "price": 15,
                        "delivery_price": 17
                    }
                ]
            },
            {
                "id": 2,
                "name": "Drinks",
                "position": 2,
                "prices": [
                    {
                        "price_id": 3,
                        "product_id": 3,
                        "position": 1,
                        "channel": "both",
                        "price": 3,
                        "delivery_price": 3
                    }
                ]
            }
        ]
    },
    "products": {
        "1": {
            "name": "Margherita Pizza",
            "description": "Classic pizza with tomato and mozzarella",
            "dispatch_method": "both",
            "modifiers": [
                {
                    "modifier_id": 1,
                    "position": 1,
                    "price": 5
                },
                {
                    "modifier_id": 4,
                    "position": 2,
                    "price": 3
                }
            ]
        },
        "2": {
            "name": "Pepperoni Pizza",
            "description": "Pizza with pepperoni and cheese",
            "dispatch_method": "both",
            "modifiers": [
                {
                    "modifier_id": 1,
                    "position": 1,
                    "price": 5
                }
            ]
        },
        "3": {
            "name": "Coca Cola",
            "description": "Soft drink",
            "dispatch_method": "both",
            "modifiers": []
        }
    },
    "modifiers": {
        "1": {
            "name": "Extra Toppings",
            "description": "Choose your extra toppings",
            "children": [
                {
                    "modifier_id": 2,
                    "position": 1,
                    "price": 2
                },
                {
                    "modifier_id": 3,
                    "position": 2,
                    "price": 2.5
                }
            ]
        },
        "2": {
            "name": "Extra Cheese",
            "description": "Add extra cheese",
            "children": [
                {
                    "modifier_id": 5,
                    "position": 1,
                    "price": 1
                }
            ]
        },
        "3": {
            "name": "Mushrooms",
            "description": "Fresh mushrooms",
            "children": []
        },
        "4": {
            "name": "Size Options",
            "description": "Choose your size",
            "children": [
                {
                    "modifier_id": 6,
                    "position": 1,
                    "price": 0
                },
                {
                    "modifier_id": 7,
                    "position": 2,
                    "price": 5
                }
            ]
        },
        "5": {
            "name": "Mozzarella",
            "description": "Premium mozzarella cheese",
            "children": []
        },
        "6": {
            "name": "Medium",
            "description": "Medium size",
            "children": []
        },
        "7": {
            "name": "Large",
            "description": "Large size",
            "children": []
        }
    }
}
🟠404Record Not Found
Modified at 2026-02-17 15:11:07
Previous
Get store details
Next
Get order details
Built with