Get time-based menu

GET

https://api.storyous.com/menu/{merchantId}/timeBased/{placeId}

Real time-based menu (e.g. daily-menu, Happy-Hours).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.storyous.com/menu/5837801c78c5400e00e57dc2/timeBased/?integrationId=&limit=7&start=2025-01-01&timeBasedMenuType=dailyMenu%2C%20happyHours' \
--header 'If-None-Match;' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "data": [
        {
            "since": "2020-12-02T23:00:00.000Z",
            "till": "2020-12-03T23:00:00.000Z",
            "timeBasedMenuType": "dailyMenu",
            "items": [
                {
                    "productId": "p:acGk1Zg1m",
                    "description": "",
                    "placeValues": {
                        "quantity": 39,
                        "priceLevels": {
                            "default": {
                                "price": 180
                            }
                        },
                        "integrationData": [],
                        "vatRate": 0.21,
                        "vatId": 1,
                        "takeawayVatRate": null,
                        "takeawayVatId": null,
                        "transitionTakeawayVatRate": null,
                        "transitionTakeawayVatId": null,
                        "showInPos": true,
                        "favouriteOrder": null,
                        "printerIds": [],
                        "printAttributes": [],
                        "maxPercentageDiscount": null,
                        "additionCategoryIds": [
                            "35",
                            "16"
                        ]
                    },
                    "decodedId": 5,
                    "type": "default",
                    "name": "Chicken McNuggets 20+3",
                    "marketingName": null,
                    "ean": null,
                    "measure": "pcs",
                    "isPriceVariable": false,
                    "imageUrl": "https://admin.story-test.com/media/thumbs/5dea5ec89e01eb0015219138_baabaaLfKhOnWx9Lp4Jq8QAl7THwmd5XRMIFDCbai.jpeg",
                    "labels": []
                }
            ],
            "menuId": "62"
        },
        {
            "since": "2020-12-03T10:00:00.000Z",
            "till": "2020-12-03T14:00:00.000Z",
            "timeBasedMenuType": "happyHours",
            "items": [
                {
                    "productId": "100",
                    "description": "Sapiente atque cum. Officia culpa asperiores. Quae veritatis tempore nesciunt neque dolorum tempora. Impedit natus minus ut reiciendis atque perspiciatis ea. Dicta voluptates eligendi inventore accusantium unde ut sint.",
                    "placeValues": {
                        "quantity": 17,
                        "priceLevels": {
                            "default": {
                                "price": 90,
                                "discount": {
                                    "originalPrice": 100,
                                    "type": "percentage",
                                    "value": 10
                                }
                            }
                        },
                        "integrationData": [],
                        "vatRate": 0.21,
                        "vatId": 16,
                        "takeawayVatRate": null,
                        "takeawayVatId": null,
                        "transitionTakeawayVatRate": null,
                        "transitionTakeawayVatId": null,
                        "showInPos": false,
                        "favouriteOrder": null,
                        "printerIds": [
                            "5e2efer4a7befc0015a4f111"
                        ],
                        "printAttributes": [],
                        "maxPercentageDiscount": null,
                        "additionCategoryIds": [
                            "34"
                        ]
                    },
                    "decodedId": 10,
                    "type": "default",
                    "name": "Test Produkt Vaškova nová skladovka [ks]",
                    "marketingName": null,
                    "ean": null,
                    "measure": "pcs",
                    "isPriceVariable": false,
                    "imageUrl": "https://admin.story-test.com/media/thumbs/5dea5ec89e01eb0015219138_baabaauXtZx6FgRu8Ms9Qzj4PCqf5VNGAvromkbai.jpeg",
                    "labels": []
                }
            ]
        }
    ]
}

Get a menu tree

Get Remaining amounts of time-based menu