list_orders
Read-only
Retrieve orders from RetailCRM with filters by status, customer, number, or date range. Get paginated summaries or full details including line items, delivery, and payments.
Instructions
List orders with filters by status, customer name, number, and created-date range. Returns (summary): pagination + array of {id, number, status, total, customer, phone, itemCount, createdAt}. Use detail:'full' for line items/delivery/payments, raw:true for the untouched payload.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | If true, return the untouched RetailCRM payload (for debugging; verbose). | |
| page | No | Page number | |
| limit | No | Results per page (max 100) | |
| detail | No | Output verbosity: 'summary' (compact, default — saves tokens) or 'full' (all shaped fields incl. line items, delivery, payments). | summary |
| filter_number | No | Filter by order number | |
| filter_status | No | Filter by order status code (e.g. 'new', 'complete'). Call list_statuses for valid codes. | |
| filter_date_to | No | Filter orders created on/before this date (YYYY-MM-DD) | |
| filter_customer | No | Filter by customer name (partial match) | |
| filter_date_from | No | Filter orders created on/after this date (YYYY-MM-DD) |