Skip to main content
Lists recent orders at a linked merchant. Use it to find an order id for buy_reorder, buy_track_order, or buy_set_substitution.
Not advertised in tools/list by default — the buy tool covers this conversationally. Expert integrations can still call it by name.

​
Parameters

ParameterTypeRequiredDescription
merchantstringYesMerchant slug (for example doordash)
limitnumberNoMax orders to return (default 10, max 50)

​
Returns

One line per order with the total, status, store name, item count, placed time, and the order id. Only a whole positive limit is applied, capped at 50. If there are no orders you get “No orders found.”

​
Example

{ "name": "buy_order_history", "arguments": { "merchant": "doordash", "limit": 5 } }