List contacts by pipeline status buckets
Returns contacts grouped by pipeline status / stage, supporting per-bucket pagination via the page map. Used by the Kanban board to fetch each column. Honors the same ownership, search, and advanced filters as the flat list endpoint.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Per-stage page numbers keyed by stage id or stage name (e.g. { "New Lead": 2 }).
Page size applied to every stage query.
Case-insensitive substring match across first/last name, full name, and phone-number value.
Filter to contacts whose source equals this value (Contacts pipeline only).
Quick-tab owner scope: my, all, team, unassigned, or a specific user _id.
Specific-tab owner ids — matches contacts where any listed user is creator, owner, or assignee. Overrides ownerFilter.
Restrict to contacts whose conversations have any of these users as assignees.
Which model to query; defaults to Contact.
Contact, Application Specific pipeline _id to query; falls back to the org's active pipeline of pipelineType.
When set, restrict the result to this single stage (by name or id) instead of returning all stages.
Legacy { start, end } createdAt window; kept for backward compatibility — prefer createdDateRange.
{ start, end } ISO range filtering on createdAt.
Map of custom-field key to value; string values use case-insensitive regex match.
Client-provided stage names to avoid a pipeline lookup; ordering controls which stages get queried.
Optional stage-name to stage-id map enabling indexed pipelineStage queries instead of legacy status-name filters.
Restrict to contacts created via bulk import (isBulkSms: true).
Message engagement filter: all, answered (has any message), or unanswered.
{ value, unit } (hours/days) — returns contacts with NO messages within that recent window.
{ start, end } window — returns contacts whose messages fall within this absolute date range.