Retrieve a paginated list of people (contacts/leads) in your team. People are the core entity in the CRM representing potential and existing customers.

Use Cases:

• Build contact lists and directories
• Export contact data to external systems
• Sync contacts with marketing platforms
• Generate reports on lead sources and stages
• Filter contacts for targeted campaigns
• Lead deduplication - find potential matches by any contact info

Filtering & Pagination:

• Use page and limit parameters for pagination
• Use email parameter to search by email address (partial, case-insensitive match)
• Use phone parameter to search by phone number (flexible formatting)
• Use stageId parameter to filter by pipeline stage (exact UUID match)
• Use assignedUserId parameter to filter by assigned user (exact UUID match)
• Use matchAny parameter to enable OR logic for filtering (e.g., matchAny=email,phone)
• Use includeTrash to include soft-deleted records
• Use includePondAccess=false with user-scoped tokens to exclude lead pond contacts
• Default: 25 people per page, maximum 100
• Use sort to control ordering (prefix with - for descending, e.g. -lastActivity)
• Use firstName, lastName, or name for partial name search (drew matches Andrew)
• Use source to filter by lead source name (comma-separated)
• Use lastActivityAfter/lastActivityBefore for activity window filtering (ISO 8601)
• Results default to newest-first (sort=-created)

OR Filtering (Lead Deduplication):

• Use matchAny=email,phone to find people matching EITHER email OR phone
• Without matchAny, multiple filters use AND logic (all must match)
• Use case: Lead deduplication - find potential matches by any available contact info