c5728da3037f
latestOpenAPI 3.0.32026-08-10601779.8 KBList contacts
Returns a paginated list of contacts (100 per page by default, up to 1000 via per_page).
Supports engagement filtering through filter[...] query parameters, so you can answer questions like "who last opened over a year ago" without paging the whole account. All filter conditions are AND-ed. Pass count_only=true to get just the number of matches — the cheapest way to size an audience before acting on it.
Query parameters
Search query for filtering contacts
Filter unsubscribed contacts
Filter by specific email
Contacts per page
Return only the number of matching contacts, with no contact records
Engagement status
Contacts whose most recent open is on or after this date
Contacts whose most recent open is before this date. Excludes contacts who never opened — use filter[never_opened] for those.
Contacts whose most recent click is on or after this date
Contacts whose most recent click is before this date
Contacts last sent to on or after this date
Contacts last sent to before this date
Contacts created on or after this date
Contacts created before this date
Only contacts who have never opened an email
Only contacts who have never clicked a link
Only contacts who have never been sent an email
Only contacts in any of these lists
Exclude contacts in any of these lists
Only contacts carrying any of these tags
Exclude contacts carrying any of these tags
Response
Successful response