Search and list customers
Paginated customer list with filters for name, email, phone, card code, tier, and RFM segment.
Authorizations
Per-company partner API key (zupy_pk_…). Validated by Zupy against the company integration key hash (Story 14.x); send it on every request as the X-API-Key header. Scoped read-write to the owning company's data.
Query Parameters
Filter by card number/code (case-insensitive contains)
Pagination cursor value from previous response.
Filter by email address (case-insensitive contains)
Filter by customer name (case-insensitive contains)
Number of results to return per page.
Filter by phone number (digits only, case-insensitive contains)
General text search across name, email, phone, and card code
Filter by RFM segment (champions, loyal, promising, at_risk, new)
Filter by loyalty tier (exact match: default, bronze, silver, gold, platinum, vip)