Get sales report
Sales totals for a period: gross and net sales, orders, items, tax, shipping, refunds and coupons used.
GET https://cotlet.dev/api/v1/woocommerce/sales-report
read
Returns the store's sales report for one period, with the totals and a day-by-day list. Pass period for week, month, last_month or year, or a custom range with date_min and date_max in YYYY-MM-DD. Without either, the report covers the current day only. The WooCommerce Analytics screens count by a Date Type setting (created, paid or completed, default Date Paid), so numbers read there can differ from a report built on another date.
Parameters
| Name | Type | Description |
|---|---|---|
| period enum | enum | week, month, last_month or year. |
| date_min date | date | Start date, YYYY-MM-DD. Use with date_max. |
| date_max date | date | End date, YYYY-MM-DD. |
Request
curl https://cotlet.dev/api/v1/woocommerce/sales-report \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("woocommerce", "get_sales_report")const result = await cotlet.call('woocommerce', 'get_sales_report');cotlet call woocommerce get_sales_reportExample response
{
"period": {
"date_min": "2026-10-05",
"date_max": "2026-10-11"
},
"total_sales": "1860.00",
"net_sales": "1744.00",
"average_sales": "249.14",
"total_orders": 31,
"total_items": 53,
"total_tax": "92.00",
"total_shipping": "88.00",
"total_refunds": 2,
"total_discount": 3,
"totals": [
{
"date": "2026-10-05",
"sales": "310.00",
"orders": 5,
"items": 9
},
{
"date": "2026-10-06",
"sales": "245.00",
"orders": 4,
"items": 7
},
{
"date": "2026-10-07",
"sales": "280.00",
"orders": 5,
"items": 8
},
{
"date": "2026-10-08",
"sales": "190.00",
"orders": 3,
"items": 5
},
{
"date": "2026-10-09",
"sales": "260.00",
"orders": 4,
"items": 7
},
{
"date": "2026-10-10",
"sales": "330.00",
"orders": 6,
"items": 10
},
{
"date": "2026-10-11",
"sales": "245.00",
"orders": 4,
"items": 7
}
]
}