list_customers
Read-only
Search and list customers by name, email, phone, or creation date. Returns customer summaries with order counts and total spent, with optional full details.
Instructions
List/search customers by name, email, phone, created-date. Returns (summary): pagination + array of {id, name, email, phone, ordersCount, totalSpent}. detail:'full' adds address/externalId/all phones.
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_name | No | Filter by customer name (partial match) | |
| filter_email | No | Filter by email address | |
| filter_phone | No | Filter by phone number | |
| filter_date_to | No | Filter customers created on/before (YYYY-MM-DD) | |
| filter_date_from | No | Filter customers created on/after (YYYY-MM-DD) |