List orders
Orders with status, total, customer and date, filtered by status, date, customer or product.
GET https://cotlet.dev/api/v1/woocommerce/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. |
Request
curl https://cotlet.dev/api/v1/woocommerce/orders \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("woocommerce", "list_orders")const result = await cotlet.call('woocommerce', 'list_orders');cotlet call woocommerce list_ordersExample response
{
"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
}