List orders
Orders with status, total, customer and date, filtered by status, date, customer or product.
MCP tool woocommerce_read → list_orders
read
Lists orders, newest first. Filter by status to build a queue such as Processing, or by date to see what came in since your last check. The status filter takes any, pending, processing, on-hold, completed, cancelled, refunded or failed; the default is any. Each page returns total and total_pages so an agent can read the whole queue. Orders are visible to the Administrator and Shop Manager roles.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | any, pending, processing, on-hold, completed, cancelled, refunded or failed. Default: any. |
| after datetime | datetime | Only orders created after this date. |
| before datetime | datetime | Only orders created before this date. |
| customer_id integer | integer | Only orders of this customer, from list_customers. |
| product_id integer | integer | Only orders that contain this product, from list_products. |
| limit integer | integer | Results per page. Default: 10. |
| page integer | integer | Page number, starting at 1. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "woocommerce_read",
"arguments": {
"operation": "list_orders",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"orders": [
{
"order_id": 1043,
"number": "1043",
"status": "processing",
"total": "34.00",
"currency": "USD",
"customer_name": "Maria Costa",
"payment_method_title": "Credit card",
"date_created": "2026-10-14T16:20:00Z",
"item_count": 2
}
],
"total": 14,
"total_pages": 2
},
"isError": false
}