• Menu: A Menu is a list of items scheduled for shipping during a week.

    • Menu ID: Menu ID is the date of the first day of the shipping week, in RFC 8601 date format: YYYY-MM-DD. It is always Sunday of the shipping week.

    • Deadline: Orders for a menu must be placed by this deadline. It is Wednesday noon pacific preceding the shipping week,unless otherwise negotiated in our business agreement.

  • Item: A list of items make up a menu. There are 5 types of items: MEAL, MARKET, PROTEIN, COLLATERAL, BUNDLE. Meals and Market Items are orderable. Proteins are not directly orderable - they are available for selection as part of a meal or market item.

    • MEAL: Meals are Intelligent Foods produced meal kits and ready-to-eat meals. There are 3 subtypes of meals; MEAL_KIT, PRE_PREPPED, and FRESH_AND_READY. Most meals, but not all, require a choice of Protein. Meal kits and pre-prepped meals serve 2, while Fresh and Ready meals serve 1. The number of servings is indicated by the unit_size attribute.

    • MARKET: Market items are Intelligent Foods produced or vendor source add-on items, such as snacks, salads, dips, proteins, or lunch bundles. Market items may allow a choice of protein. The item’s quantity attribute indicates the quantity that will be delivered per ordered item.

    • PROTEIN: Meals and market items may require a choice of accompanying protein or optionally allow a protein upgrade. Items that require a protein choice will list a base_protein, which will be included with the item if no choice is indicated. Many items permit alternate protein choices, indicated by available_proteins. Items that include available_proteins but do not indicate a base_protein imply that protein upgrades are available but not required or included in the base price.

    • COLLATERAL: Collateral items are non-menu items that may optionally be included with an order, such as booklets, pamphlets, advertisements, etc. They should NOT be displayed to the user. You should include the ID of the collateral items in any order in which you wish the user to receive the collateral item. For example, the Welcome Booklet is typically included with the orders for first-time users.

    • BUNDLE: Bundles are collections of items that may be ordered using a single item ID. These are special purpose items and will only appear in the menu under arrangement with Intelligent Foods.

    Some item attributes vary depending on the selected protein. For example, diet types, ingredients, nutrition, and even images may change if a beef, seafood, or soy protein is selected. The attribute protein_specific_overrides provides attributes that are specific to the specific item and protein combination.

  • Delivery Date: Intelligent Foods schedules deliveries between Sunday and Thursday. Delivery is not available to all zip codes on all weekdays. Retrieve Zip Code Availability to determine which delivery dates are available for the zip code. Only dates listed in the Availability response are available for delivery.

  • Availability: Availability applies to every item in a menu and should be considered before presenting a user with a menu of item choices. There are 2 non-available states: unavailable and sold_out.

    Items should always be filtered using availability information prior to presenting a menu to a user. You should not display unavailable items. You may choose to not display sold_out items, alternatively they may be displayed with a sold-out indicator.

    There are 2 Availability endpoints:

    • Universal Availability: Combined availability for all serviceable zip codes. This provides a “most conservative” view of availability, suitable for presenting a “logged out” version of the menu that includes only those items known to be available to all zip codes on all delivery days.

    • Zip Code Availability: Available delivery dates and availability per delivery day for the specified zip code.

    While menus may be cached as they do not typically change, Availability should not be. The Availability endpoints report real-time availability information.

  • Order: An Order is a request to deliver 1 or more items to an address on a date. An order will result in 1 or more Shipments.

  • Shipment: A Shipment is a box to be delivered to an address on a date. An order will result in 1 or more Shipments. Each Shipment indicates the carrier and tracking code.