# alibaba1688_list_orders (https://sellersheetai.com/docs/mcp-api/tools/alibaba1688_list_orders)

> List the 1688 account's purchase orders, newest first — every order of the account, not only those created here; read one with alibaba1688_get_order.

Access: **READ** · toolset alibaba1688 · family null

## Call it

MCP tool call:

```json
{
  "name": "alibaba1688_list_orders",
  "arguments": {
    "account": "<account>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_list_orders \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"<account>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
| `page` | integer |  | the page number, from 1. |
| `page_size` | integer |  | orders per page, 1 to 50. |
| `status` | string |  | 1688's own order status to keep, e.g. waitbuyerpay (unpaid), waitsellersend (paid, not shipped), waitbuyerreceive (shipped), success, cancel; omit for all. |

## Result

- `data.orders[]` — order_id, status, supplier, supplier_company, total_fen, freight_fen, created_at, paid_at, close_reason, tracking [{carrier, number}], lines[] (entry_id, offer_id, spec_id, subject, variant, quantity, unit, unit_price_fen, amount_fen, status). Amounts are integers in fen.
- `data.total` — orders matching; data.has_more: true when another page exists.
- `data.page / data.page_size` — as asked.