Menus & restaurant detail

​

get_menu

{
  "menus": [
    {
      "id": "menu_lunch",
      "restaurantId": "rest_lb_steakhouse",
      "providerMenuId": "dlv_menu_123",
      "name": "Lunch",
      "description": "",
      "sortOrder": 0,
      "availabilityWindows": [{ "day": "mon", "startTime": "11:00", "endTime": "15:00" }],
      "menuVersionId": "ver_9"
    }
  ],
  "items": [
    {
      "id": "item_filet",
      "restaurantId": "rest_lb_steakhouse",
      "menuId": "menu_lunch",
      "menuName": "Lunch",
      "menuSortOrder": 0,
      "category": "Mains",
      "categorySortOrder": 1,
      "sortOrder": 3,
      "name": "Filet Mignon",
      "description": "8oz",
      "imageUrl": null,
      "priceCents": 4200,
      "availability": "available | unavailable",
      "availabilityWindows": [],
      "mappingStatus": "mapped | needs_review",
      "modifierGroupIds": ["mg_temp"],
      "calories": 620,
      "productTags": [{ "code": 104, "label": "Eggs", "group": "allergen" }],
      "isCombo": false,
      "menuVersionId": "ver_9"
    }
  ],
  "modifierGroups": [],
  "modifiers": [],
  "mappings": []
}

• A restaurant serves all of its menus as siblings, not as versions of each other. Each has its own availabilityWindows (empty/absent = always available). Render one menu at a time.
• Display ordering: each item carries three positions — menuSortOrder (position of the item’s menu within the restaurant, mirroring that menu object’s own sortOrder, so the two never disagree), categorySortOrder (position of the category within its menu), and sortOrder (position of the item within its category). Sort by menuSortOrder before categorySortOrder before sortOrder. Two menus can each send a category with sortOrder: 0, so category order is only meaningful within a menu. All three are optional on an item — they’re always set on fresh imports, but rows from before menus were tracked may omit them; treat a missing value as 0.
• Items with no menuId are legacy rows imported before menus were tracked — treat them as belonging to the restaurant’s only/first menu.
• An item’s availabilityWindows are the effective windows (menu opening hours, unless the category or the product overrides them). Combined with the restaurant’s openingHours, this is what lets a client grey out an item that exists but is not orderable at the selected fulfillment time. Enforced server-side too (item_unavailable_at_time).
• Modifiers can nest: a modifier may own childModifierGroupIds pointing back into the same flat top-level collections. defaultQuantity >= 1 means it comes pre-selected (marketplace menus carry the provider’s own merchant defaults this way; send them unless the user removes them, or the provider fills a default into any modifier group the line leaves out). Groups with isBundleSection: true belong to a meal deal (isCombo items); maxPerModifier caps repeats of a single modifier independently of the group total.

• store_is_open — the store’s open state right now. false means no ASAP order is possible.
• supports_order_ahead — present when store_is_open is false. true means the closed store still takes scheduled orders: build the cart and quote a later time. false means item adds and validation fail even for scheduled slots; do not build a cart.
• store_next_open_time — ISO instant a closed store reopens, when known. It is not the store’s hours or closing time: which times the provider will schedule is only known from quote_order (see scheduled times on marketplace supply).
• promotions — the store’s active, cart-independent deals, once per menu: [{ "id": "dae14fad-…", "title": "$3 off orders $15+", "description": "Use code: PEPSI3OFF. Must add eligible item to cart." }]. id is the provider’s campaign handle, not a code a person types. Items list the deals they qualify for in promotionIds (values of promotions[].id), present only when non-empty. An item with no promotionIds can still be discounted by a subtotal-wide deal. Whether a deal applies, and for how much, is only known from quote_order (provider discounts arrive as negative line items and in promoDiscountCents) — never promise an amount from the menu. Absent when the store has no deals and on the single-item (item_id) response. Deals are evaluated at placement for the slot you pass, so a deal active while browsing applies to a scheduled order placed now. In every case observed only one promotion applied per cart and the provider chose which, not necessarily the largest — never add deals up or promise a particular one. Still never promise an amount — quote_order for the actual slot is the authority.
• fulfillment_address (input, optional) — the dropoff you are browsing for (address1 and/or latitude/longitude, plus city/state/postal_code). Deal eligibility is address-dependent and the provider account’s default address may be someone else’s, so the menu is read for this address when it matches one saved on the account; otherwise the account default is used. Pass the same dropoff you will quote with.

​

get_restaurant_detail

{
  "restaurant": {
    "id": "rest_lb_steakhouse",
    "name": "LB Steakhouse",
    "location": "Redwood City, CA",
    "timezone": "America/Los_Angeles",
    "imageUrl": null,
    "cuisineType": "steakhouse",
    "description": null,
    "rating": 4.6,
    "deliveryFee": null,
    "minimumOrder": null,
    "supportsCatering": true,
    "prepTimeMinutes": 20,
    "minimumLeadTimeMinutes": 0,
    "deliveryMinLeadTimeMinutes": 95,
    "deliveryCourier": "deliverthat",
    "deliveryTransitEstimateMinutes": 18,
    "resolvedMinLeadTimeMinutes": { "pickup": 20, "delivery": 95 },
    "busyState": { "status": "busy", "delayMinutes": 20, "receivedAt": "2026-08-06T18:00:00.000Z" },
    "openingHours": [{ "day": "mon", "startTime": "11:00", "endTime": "21:00" }],
    "fulfillmentTypesSupported": ["pickup", "delivery"],
    "selfDeliversEnabled": false,
    "deliverThatCoverage": "unknown",
    "agentOrderingEnabled": true
  },
  "location": {
    "id": "loc_1",
    "name": "Redwood City",
    "address1": "1 Main St",
    "city": "Redwood City",
    "state": "CA",
    "postalCode": "94063",
    "latitude": 37.4852,
    "longitude": -122.2364
  },
  "menus": [],
  "categories": [{ "name": "Mains", "itemCount": 12, "menuId": "menu_lunch", "menuName": "Lunch" }]
}

• The tool returns restaurant, location, menus, categories only. Timing fields are mirrored onto restaurant so they survive that trim.
• categories are scoped per menu (menuId/menuName): two menus can each own a “Sides”, and merging them would report one oversized category no single menu actually has.
• selfDeliversEnabled is already reflected in fulfillmentTypesSupported (delivery is stripped when a store neither self-delivers nor has a courier); it is surfaced explicitly so a client can explain why a store is pickup-only. For self-delivery orders the pickup and delivery times are the same instant — the 15-minute courier collection lead only applies when a real courier collects.

​

check_delivery_availability

{
  "restaurant_id": "rest_lb_steakhouse",
  "dropoff": {
    "address1": "500 Broadway",
    "address2": "Suite 210",
    "city": "Redwood City",
    "state": "CA",
    "postal_code": "94063",
    "latitude": 37.4852,
    "longitude": -122.2364
  },
  "requested_fulfillment_time": "2026-08-11T19:00:00.000Z",
  "order_cost_cents": 4200
}

{
  "available": true,
  "checked": true,
  "reason": null,
  "feeCents": 899,
  "coverage": "supported | unsupported | unknown",
  "estimatedPickupTime": "2026-08-11T18:45:00.000Z",
  "estimatedDropoffTime": "2026-08-11T19:05:00.000Z",
  "quoteId": "dt_quote_1",
  "quoteExpiresAt": "2026-08-11T18:15:00.000Z"
}