List contacts (v2)

Match contacts whose id is in this set (single id or array).

Exclude contacts whose id is in this set (single id or array).

Relationship priority tier: a tier number, an array of tiers (OR), or a boolean (true = any tier set, false = none).

LinkedIn slug: an exact slug string, or a boolean for presence/absence of a LinkedIn handle.

Instagram slug: an exact slug string, or a boolean for presence/absence of an Instagram handle.

Twitter/X slug: an exact slug string, or a boolean for presence/absence of a Twitter handle.

Contact source: a single source string or an array of sources (OR).

Full name: a bare string (fuzzy contains), an array of exact names, or { contains } / { eq } for explicit fuzzy vs exact match.

Group membership: a group id, an array of group ids (OR), a boolean for any/no group, or { not } to exclude group id(s).

Keep-in-touch cadence: a frequency string, or a boolean for presence/absence of a cadence.

Location: a string (fuzzy, accent-insensitive match), or a boolean for presence/absence of a location.

Job title: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq } for explicit fuzzy vs exact match.

Birthday: a specific date (matches on day + month), or true for any birthday set.

Tags: an array of tag ids (OR), or { not } to exclude tag id(s).

Company: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq } for explicit fuzzy vs exact match.

Education: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq }.

Description/notes: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq }.

LinkedIn companies text: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq }.

LinkedIn education text: a bare string (fuzzy contains), a boolean for presence/absence, or { contains } / { eq }.

Exclude contacts whose full name fuzzily matches this string / any of these strings.

Exclude contacts whose company fuzzily matches this string / any of these strings.

Exclude contacts whose job title fuzzily matches this string / any of these strings.

Exclude contacts whose education fuzzily matches this string / any of these strings.

Exclude contacts whose description fuzzily matches this string / any of these strings.

Exclude contacts whose LinkedIn companies text fuzzily matches this string / any of these strings.

Exclude contacts whose LinkedIn education text fuzzily matches this string / any of these strings.

LinkedIn last-message time: a boolean for presence/absence, or a { gte?, lte? } ISO 8601 range.

Last-seen (last interaction) time — alias for has_interaction: a boolean for presence/absence, or a { gte?, lte? } ISO 8601 range.

Interaction (last-seen) time: a boolean for presence/absence, or a { gte?, lte? } ISO 8601 range.

Next-reminder time: a boolean for presence/absence, or a { gte?, lte? } ISO 8601 range.