get the recommended Grubhub ordering workflow and safety rules.

call this before building an order, especially for campus-card orders.

Log in to Grubhub with email and password. Returns session info on success.

Log out of the current Grubhub session.

Get current authentication state and session info.

Send a one-time passcode to the given email for login.

Verify a one-time passcode and complete login.

Create a new Grubhub account.

Send a password reset OTP to the given email.

search for restaurants near a location.

Args: latitude: Latitude of the delivery address longitude: Longitude of the delivery address query: Optional search query (cuisine, restaurant name, dish) page_size: Number of results per page (default 20) page_num: Page number for pagination (1-based, default 1) sort_type: Optional sort; leave empty for default relevance location_mode: DELIVERY, PICKUP, CAMPUS, ONSITE, or PICKUP_CAMPUS (default DELIVERY)

search Grubhub campus/onsite restaurants near a campus location.

use this for campus-card dining. it sets Grubhub locationMode=CAMPUS.

Args: latitude: Latitude of the campus pickup/delivery location longitude: Longitude of the campus pickup/delivery location query: Optional restaurant or dish query page_size: Number of results per page (default 20) page_num: Page number for pagination (1-based, default 1)

get autocomplete suggestions for a search query.

Args: query: The partial search text latitude: Latitude for location context longitude: Longitude for location context location_mode: DELIVERY or PICKUP (default DELIVERY)

get restaurant details including menu, hours, ratings, and delivery info.

Args: restaurant_id: The Grubhub restaurant ID latitude: Optional latitude for delivery estimates longitude: Optional longitude for delivery estimates order_type: Order type - standard, catering (default standard)

get the full menu for a restaurant including categories, items, and prices.

This is the same as get_restaurant; the v4 endpoint returns the full menu.

Args: restaurant_id: The Grubhub restaurant ID latitude: Optional latitude for availability longitude: Optional longitude for availability

get details for a specific menu item including options, add-ons, and pricing.

Args: restaurant_id: The Grubhub restaurant ID item_id: The menu item ID order_type: Order type - standard, catering (default standard) latitude: Optional latitude for availability longitude: Optional longitude for availability

create a new cart with the first item.

Args: restaurant_id: The restaurant ID to order from menu_item_id: The menu item ID to add quantity: Number of this item (default 1) special_instructions: Special preparation instructions options: List of selected options/add-ons, each with {id, quantity} latitude: Delivery latitude longitude: Delivery longitude is_delivery: True for delivery, False for pickup

set pickup contact information on a cart before checkout.

Args: cart_id: The cart ID name: Pickup contact name phone: Pickup contact phone number email: Pickup contact email address pickup_instructions: Optional pickup instructions

mark a cart for delivery with coordinates before full address is set.

Args: cart_id: The cart ID latitude: Delivery latitude longitude: Delivery longitude

get the current state of a cart including items, totals, and fees.

Args: cart_id: The cart ID

add an item to an existing cart.

Args: cart_id: The cart ID to add to restaurant_id: The restaurant ID for the item menu_item_id: The menu item ID to add quantity: Number of this item (default 1) special_instructions: Special preparation instructions options: List of selected options/add-ons, each with {id, quantity}

update the quantity of an item in the cart.

Args: cart_id: The cart ID line_item_id: The line item ID to update quantity: New quantity (0 to remove)

remove an item from the cart.

Args: cart_id: The cart ID line_item_id: The line item ID to remove

apply a promotion code to the cart.

Args: cart_id: The cart ID promo_code: The promotion code to apply

set the tip amount on the cart.

Args: cart_id: The cart ID tip_amount: Tip amount in dollars

place an order from a cart. (AUTH'D)

Args: cart_id: The cart ID to submit as an order payment_method_id: Optional payment method ID to attach before checkout payment_type: Payment type for payment_method_id, such as CREDIT_CARD or CAMPUS_CARD tip_amount: Optional tip amount in dollars

get details for a specific order.

Args: order_id: The order ID

get past order history. (AUTH'D)

Args: page_size: Number of orders per page (default 10) page_num: Page number (default 0)

get real-time tracking info for an active order.

Args: order_id: The order ID to track

create a new cart from a previous order for easy reordering.

Args: order_id: The order ID to reorder

add or update the tip after delivery.

Args: order_id: The order ID tip_amount: Tip amount in dollars

get the current user's profile information (AUTH'D)

update user profile information. (AUTH'D)

Args: first_name: New first name last_name: New last name phone: New phone number

get saved delivery addresses. (AUTH'D)

add a new delivery address. (AUTH'D)

Args: street_address: Street address line city: City name state: State abbreviation (e.g. NY, CA) zip_code: ZIP code apt_suite: Apartment/suite number delivery_instructions: Special delivery instructions label: Label for the address (e.g. Home, Work)

get favorite/saved restaurants. (AUTH'D)

add a restaurant to favorites. (AUTH'D)

Args: restaurant_id: The restaurant ID to favorite

remove a restaurant from favorites. (AUTH'D)

Args: restaurant_id: The restaurant ID to unfavorite

change account password. (AUTH'D)

Args: current_password: Current password new_password: New password

get account-level saved payment methods. (AUTH'D)

campus cards are cart-scoped on Grubhub. use get_cart_payment_options after creating a cart to see whether CAMPUS_CARD is available.

get the calculated bill for a cart, including checkout validation.

get cart-scoped payment options, including campus-card availability.

get live CarolinaCard/campus-card balances from Grubhub.

Args: cart_id: Optional cart ID for checkout-context tender eligibility restaurant_id: Optional restaurant ID for checkout-context tender eligibility selected_payment_id: Optional selected campus tender/payment ID include_raw: Include Grubhub's raw campus-card balance response

attach a saved payment method to a cart.

Args: cart_id: The cart ID payment_type: Grubhub payment type, such as CREDIT_CARD or CAMPUS_CARD payment_id: Payment method ID amount_cents: Optional amount in cents; omit to cover remaining balance

attach the linked campus card, such as CarolinaCard, to a cart.

Args: cart_id: The cart ID payment_id: Campus-card payment ID; default is campus_card amount_cents: Optional amount in cents; omit to cover remaining balance

check the balance of a Grubhub gift card.

Args: card_number: Gift card number pin: Gift card PIN

apply a gift card to a cart.

Args: cart_id: The cart ID card_number: Gift card number pin: Gift card PIN

get USC CarolinaCard meal-swipe rules used by optimizer tools.

estimate whether a USC retail meal swipe is a good payment choice.

Args: cart_total_cents: Cart total in cents from get_cart_payment_options meal_period: breakfast, lunch, dinner, or late_night swipes_remaining: optional known remaining retail swipes meal_plan_dollars_cents: optional known Meal Plan Dollars balance carolina_cash_cents: optional known CarolinaCash balance