List WooCommerce Orders
woocommerce_list_ordersRetrieve a filtered list of WooCommerce orders by status, customer, date range, or product. Supports pagination and sorting for efficient order management.
Instructions
Search and list store orders, with filters for status, customer, date range, and product.
Args:
status: 'any'|'pending'|'processing'|'on-hold'|'completed'|'cancelled'|'refunded'|'failed'|'trash' (default: any)
customer (number, optional): customer ID
search (string, optional)
after / before (string, optional): ISO8601 dates bounding date_created
product (number, optional): only orders containing this product ID
orderby / order: sorting (default date/desc)
page / per_page: pagination (default page=1, per_page=20, max 100)
response_format ('markdown'|'json'): default 'markdown'
Returns: paginated list of orders with id, number, status, total, currency, customer, and line item count.
Examples:
Use when: "show me pending orders from this week" -> status="pending", after="2026-06-29T00:00:00"
Use when: "how many orders has customer 15 placed" -> customer=15
Don't use when: you need full line-item and address detail for one order (use woocommerce_get_order)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to retrieve, 1-based (default: 1) | |
| after | No | ISO8601 date - only orders created after this date | |
| order | No | Sort direction (default: desc) | desc |
| before | No | ISO8601 date - only orders created before this date | |
| search | No | Search term (matches order number, billing details, etc.) | |
| status | No | Filter by order status (default: any) | any |
| orderby | No | Sort field (default: date) | date |
| product | No | Filter to orders that contain this product ID | |
| customer | No | Filter to orders from a specific customer ID | |
| per_page | No | Number of results per page, 1-100 (default: 20) | |
| response_format | No | Output format: 'markdown' for human-readable text or 'json' for machine-readable structured data | markdown |