> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buy_order_history

> List recent orders at a linked merchant

Lists recent orders at a linked merchant. Use it to find an order id for `buy_reorder`, `buy_track_order`, or `buy_set_substitution`.

<Note>Not advertised in `tools/list` by default — the [buy](/companies/mcp/tools/buy) tool covers this conversationally. Expert integrations can still call it by name.</Note>

## Parameters

| Parameter  | Type   | Required | Description                               |
| ---------- | ------ | -------- | ----------------------------------------- |
| `merchant` | string | Yes      | Merchant slug (for example `doordash`)    |
| `limit`    | number | No       | Max 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

```json theme={null}
{ "name": "buy_order_history", "arguments": { "merchant": "doordash", "limit": 5 } }
```