List Contacts
Contacts
List Contacts
Retrieves a paginated list of contacts inside the workspace with support for full-text search and complex filters (tags, custom fields, subscription, segments, date ranges, etc.).
GET
List Contacts
Use this endpoint to retrieve a paginated list of contacts in your workspace.
All query parameters are optional. By default, the API returns the first 10 contacts.
You can use the
q parameter for a full-text search across names, emails, and phone numbers. You can also use advanced filtering by combining tags, custom fields, segments, and date ranges.Authorizations
Query Parameters
Page number for pagination
Number of items per page (max: 100)
Free-text search query matching first name, last name, phone number, or email.
Filter by WhatsApp subscription status.
Filter by tags using comma-separated Tag IDs (e.g. id1,id2). Use in combination with tagsMode.
Filter by segment ID(s). Comma-separated list supported.
Filter contacts created on or after this ISO date-time.
Filter contacts created on or before this ISO date-time.
