Pizza AI Ordering API (2.0.0)

Returns a list of available menus with their category names. Use this at conversation start to help customers browse.

IMPORTANT: The order_type query parameter is required.

Typical workflow:

1. Call this endpoint with order_type at conversation start
2. Use menu_id and category info to help customer browse
3. Call /menu/{menu_id}/categories to get items in each category
4. When customer selects an item, call /menu/{menu_id}/{item_id} for full details

Returns all categories with their items for browsing. Use this to show customers what's available in each category.

Note: This returns item summaries only (no options). You MUST call /menu/{menu_id}/{item_id} before adding any item to cart.

Returns complete details for a menu item including all customization options.

CRITICAL: You must call this endpoint before adding any item to the cart to get:

• Available sizes and their prices
• Crust options
• Sauce options
• Cheese options
• Topping options with min/max quantities

Option types:

• single_select: Customer chooses exactly ONE (e.g., size, base sauce)
• multi_select_quantity: Customer can choose multiple with quantities (e.g., toppings)

Note: Simple items like drinks or dips may not have options - they can be added directly to cart.

Creates a new shopping cart for the customer's session. Call this first at the start of every conversation.

The returned orderId must be stored and used for all subsequent cart operations.

Requirements:

• phone_number: Customer's 10-digit phone number (formats accepted: 6045551234, 604-555-1234, (604) 555-1234)

Typical workflow:

1. Create cart with phone_number
2. Fetch menu and categories
3. Add items as customer orders
4. Submit order when ready

Returns the current cart with all items, quantities, and calculated totals.

Use this to:

• Show the customer their current order
• Get line_id values for updating/removing items
• Verify cart contents before checkout

Adds a menu item to the cart with selected options.

Before calling this endpoint:

1. Get full item details from GET /menu/{menu_id}/{item_id}
2. Collect all required options from the customer (size, crust, etc.)

selected_options format: Array of objects with option_id and selections:

[
  {
    "option_id": "menu_874_categories_521_items_847_itemAttributes_428",
    "selections": [
      {
        "selection_id": "menu_874_categories_521_items_847_itemAttributes_428_values_831",
        "name": "Large 14\"",
        "quantity": 1
      }
    ]
  }
]

CRITICAL: Use exact selection_id values from the menu API - never simplify to names like "large" or "pepperoni"

For items WITHOUT options (drinks, dips):

• Set selected_options to empty array [] or omit it

Adds multiple items to the cart in a single API call. More efficient than calling add_cart_item multiple times.

Use cases:

• Customer orders multiple pizzas at once ("3 large pepperoni pizzas")
• Customer orders different items ("a pepperoni and a hawaiian")
• Bulk add with drinks and sides

Partial success: Some items may succeed while others fail. Check added_count and error_count in response.

Updates an existing item in the cart. Use this when customer wants to:

• Change quantity ("make that 2 pizzas instead of 1")
• Change size ("actually, make it a large")
• Change toppings or other options

To get the line_id: Call GET /cart/{orderId} and find the item in the items array.

Partial updates: You can update just quantity, just selected_options, or both. If selected_options is provided, it replaces ALL existing options.

Removes an item from the cart entirely.

To get the line_id: Call GET /cart/{orderId} and find the item in the items array.

Note: To change quantity to 0, use this endpoint instead of PATCH.

Creates an order from the cart contents and submits it for preparation.

Required information:

• orderId: Cart must have at least one item
• customer.name: Customer's name for the order
• customer.phone: Contact phone number
• order_type: "pickup" (default) or "delivery"
• delivery_address.street: Required for delivery orders only

Order details:

• Pickup: Ready in 20-40 minutes, pay cash at counter
• Delivery: Ready in 35-55 minutes, $4.99 delivery fee, pay cash on delivery

After successful submission:

• Cart items are cleared automatically
• Order number (orderId) is used for tracking
• Estimated ready time is provided

Returns the current status and details of an order.

Order statuses:

• confirmed: Order received and being prepared
• preparing: Kitchen is making the order
• ready: Order is ready (for pickup) or being dispatched (for delivery)
• out_for_delivery: Driver is on the way (delivery only)
• completed: Order has been picked up or delivered
• cancelled: Order was cancelled

Response includes:

• Current status with human-readable message
• minutes_remaining: Time until estimated ready time (0 if past)
• Full order details (items, totals, customer info)