This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Menu Item with a Time-Specific Price

When a menu item is priced using the Time Specific Price pricing strategy, its pricingStrategy value is TIME_SPECIFIC_PRICE and its pricingRules value contains the information you need to calculate the price of the item at any given time. Inside the pricingRules value, you see the timeSpecificPricingRules value which contains an array of time-specific prices for the menu item.

In this use case, the pricingRules value also contains the sizeSpecificPricingGuid and sizeSequencePricingRules values, however, the sizeSpecificPricingGuid is null and the sizeSequencePricingRules array is empty because the menu item uses a time-specific price, not a size price.

Sample JSON for a menu item that uses the Time Specific Price pricing strategy

{
  "restaurantGuid": "2071fb81-988b-4d75-b8dc-c5c17cff9706",
  ...
  "menus": [
    {
      "name": "Dinner",
      "guid": "ddd681de-3c12-4d45-b8b1-a5b2ea898210",
      ...
      "menuGroups": [
        {
          "name": "Pizza",
          "guid": "dc868006-919a-4950-a4cc-3a03f9770fd7",
          ...
          "menuItems": [
            {
              "name": "Cheese Pizza",
              "guid": "6f54db28-557b-4070-b3da-58a52fa4a4fb",
              ...
              "price": null,
              "pricingStrategy": "TIME_SPECIFIC_PRICE",
              "pricingRules": {
                "timeSpecificPricingRules": [
                  {
                    "timeSpecificPrice": 8.0,1
                    "basePrice": 10.0,2
                    "schedule": [3
                      {
                        "days": [4
                          "MONDAY",
                          "TUESDAY",
                          "WEDNESDAY",
                          "THURSDAY",
                          "FRIDAY"
                        ],
                        "timeRanges": [5
                          {
                            "start": "12:00",
                            "end": "14:00"
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "timeSpecificPrice": 9.0,6
                    "basePrice": 10.0,
                    "schedule": [
                      {
                        "days": [
                          "SATURDAY",
                          "SUNDAY"
                        ],
                        "timeRanges": [
                          {
                            "start": "12:00",
                            "end": "15:00"
                          }
                        ]
                      }
                    ]
                  }
                ],
                "sizeSpecificPricingGuid": null,
                "sizeSequencePricingRules": []
              },
              ...
            },
          ]
        }
      ]
    }
  ],
  "modifierGroupReferences": {
    ...
  },
  "modifierOptionReferences": {
    ...
  }
}

1

The price of the Cheese Pizza menu item during the time period defined by the schedule value ($8).

2

The base price of the Cheese Pizza menu item ($10), used for time periods when a time-specific price has not been defined.

3

The schedule for this time specific price, which defines the days and times the price applies.

4

The days this time-specific price applies (Monday through Friday).

5

The times this time-specific price applies (noon to 2pm), in the restaurant's local time.

6

The configuration for another time-specific price for Saturday and Sunday.