Storyous Public APIs
  1. Menu API
Storyous Public APIs
  • Introduction
  • Merchants API
    • Get merchant and all its places
  • Menu API
    • Get a menu tree
      GET
    • Get time-based menu
      GET
    • Get Remaining amounts of time-based menu
      GET
  • Bills API
    • Get list of payment bills
    • Get detail of a payment bill
  • Delivery API
    • Create an order through delivery API
    • Get status of delivery order
  • Deskview API
    • Get list of desks
    • Get list of sections
    • Get desk view of a place
  • Features API
    • Get list of merchants/places with a feature
  • Hotel accounts integration API
    • Provide list of accounts
    • Write consumed items to hotel account
  • Stocks API
    • Get list of stocks
    • Get list of items
    • Get list of stock ups
    • Get detail of stock up
    • Create new stock up
    • Modify stock up
    • Delete stock up
    • Get list of stock takings
    • Get detail of stock taking
    • Create new stock taking
    • Modify stock taking
    • Delete stock taking
    • Get suppliers
  • Loyalty API
    • Introduction
    • Get benefit offer
    • Report offer validation error
    • Report benefit usage
    • Get loyalty benefit usages
    • Mark benefit usages as synchronized
  • DataSync
    • Webhook receiving endpoint
      • Receive new or updated records
    • Data domains
      • Stock management
        • Stocks domain
        • StockItemCategories domain
        • StockItems domain
        • StockMovements domain
      • Sales and costs
        • Bills domain
        • BillCosts domain
        • TerminalTransactions domain
        • PaymentTypes domain
        • Loyalty domain
      • Desks
        • DeskSections domain
        • Desks domain
      • Menu
        • ItemCategories domain
        • Items domain
        • PlaceITems domain
      • Merchants
        • Merchants domain
        • Places domain
        • Persons domain
  • Schemas
    • Schemas
      • Loyalty api
        • BalanceBenefitOfferRequest
        • ThirdPartyLoyaltyOfferRequest
        • LoyaltyOfferValidationError
        • LoyaltyBenefitUsagesPayload
        • BenefitInput
        • PaidItem
        • Applied Benefits
        • PaymentByBalance
        • UsedBalance
        • LoyaltyOfferResponse
        • MenuProductDefinition
        • UsedGeneralDiscount
      • Desk
      • Section
  1. Menu API

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

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.storyous.com/menu/5837801c78c5400e00e57dc2/timeBased/?integrationId=&limit=7&start=2025-01-01&timeBasedMenuType=dailyMenu, happyHours' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "since": "2020-12-02T23:00:00.000Z",
            "till": "2020-12-03T23:00:00.000Z",
            "timeBasedMenuType": "dailyMenu",
            "items": [
                {
                    "productId": "p:saThrc2dm",
                    "decodedId": 5,
                    "type": "default",
                    "name": "Chicken McNuggets 20+3",
                    "marketingName": null,
                    "ean": null,
                    "measure": "pcs",
                    "isPriceVariable": false,
                    "description": "",
                    "imageUrl": "https://admin.story-test.com/media/thumbs/5dea5ec89e01eb0015219138_baabaaLfKhOnWx9Lp4Jq8QAl7THwmd5XRMIFDCbai.jpeg",
                    "labels": [],
                    "placeValues": {
                        "priceLevels": {
                            "default": {
                                "price": 1825
                            }
                        },
                        "integrationData": [],
                        "vatRate": 0.21,
                        "vatId": 1,
                        "takeawayVatRate": null,
                        "takeawayVatId": null,
                        "showInPos": true,
                        "printerIds": [
                            "5e3151838448090015c642e5"
                        ]
                    }
                },
                {
                    "productId": "p:4czFhMXMz",
                    "decodedId": 4,
                    "type": "default",
                    "name": "Pizza Hawaii",
                    "marketingName": null,
                    "ean": null,
                    "measure": "pcs",
                    "isPriceVariable": false,
                    "description": "The best pizza option on the World!",
                    "imageUrl": "https://admin.story-test.com/media/thumbs/5dea5ec89e01eb0015219138_baabaanQmSqYy9Kn1Fl2JscWIvj8XOGztokhfebai.jpeg",
                    "labels": [],
                    "placeValues": {
                        "priceLevels": {
                            "default": {
                                "price": 20
                            }
                        },
                        "integrationData": [
                            {
                                "integrationId": "customdelivery",
                                "enabled": true,
                                "externalId": null
                            }
                        ],
                        "vatRate": 0.21,
                        "vatId": 1,
                        "takeawayVatRate": null,
                        "takeawayVatId": null,
                        "showInPos": true,
                        "printerIds": [
                            "5e3151838448090015c642e5"
                        ]
                    }
                }
            ]
        },
        {
            "since": "2020-12-03T10:00:00.000Z",
            "till": "2020-12-03T14:00:00.000Z",
            "timeBasedMenuType": "happyHours",
            "items": [
                {
                    "productId": "p:acGk1ZG1m",
                    "decodedId": 10,
                    "type": "default",
                    "name": "Test Produkt Vaškova nová skladovka [ks]",
                    "marketingName": null,
                    "ean": null,
                    "measure": "pcs",
                    "isPriceVariable": false,
                    "description": "",
                    "imageUrl": "https://admin.story-test.com/media/thumbs/5dea5ec89e01eb0015219138_baabaauXtZx6FgRu8Ms9Qzj4PCqf5VNGAvromkbai.jpeg",
                    "labels": [],
                    "placeValues": {
                        "priceLevels": {
                            "default": {
                                "price": 90,
                                "discount": {
                                    "originalPrice": 100,
                                    "type": "percentage",
                                    "value": 10
                                }
                            }
                        },
                        "integrationData": [],
                        "vatRate": 0.21,
                        "vatId": 1,
                        "takeawayVatRate": null,
                        "takeawayVatId": null,
                        "showInPos": false,
                        "printerIds": []
                    }
                },
            ]
        }
    ]
}
Previous
Get a menu tree
Next
Get Remaining amounts of time-based menu
Built with