Sign in

v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB
contacts

Search and filter contacts

Search contacts with flexible filters: name, LinkedIn URL, lifecycle stage, outreach status, tags, hot score, campaign membership, and more. Supports pagination and sorting.

get/contacts/search

Query parameters

linkedinUrlstring

Filter by LinkedIn URL (exact match)

Filter by LinkedIn URL (exact match)

namestring

Filter by name (partial match)

Filter by name (partial match)

lifecycleStage'contact' | 'lead' | 'qualified' | 'approved' | 'rejected'
sortBystring

Sort order. One of: updatedAt_desc / updatedAt_asc (most recent activity — default), hotScore_desc / hotScore_asc, lastRepliedAt_desc / lastRepliedAt_asc, lastContactedAt_desc / lastContactedAt_asc, createdAt_desc / createdAt_asc, name_asc / name_desc, profileUpdatedAt_desc / profileUpdatedAt_asc.

Sort order. One of: updatedAt_desc / updatedAt_asc (most recent activity — default), hotScore_desc / hotScore_asc, lastRepliedAt_desc / lastRepliedAt_asc, lastContactedAt_desc / lastContactedAt_asc, createdAt_desc / createdAt_asc, name_asc / name_desc, profileUpdatedAt_desc / profileUpdatedAt_asc.

minHotScoreinteger
outreachStatus'none' | 'connection_sent' | 'connected' | 'dm_sent' | 'followed_up' | 'replied' | 'in_conversation' | 'meeting_booked' | 'converted' | 'not_interested'
tagstring

Filter by tag

Filter by tag

doNotContact'true' | 'false'
hasProfileData'true' | 'false'
campaignIdstring
limitinteger
offsetinteger

Response

Matching contacts

successtrue required
creditsUsedinteger required

Credits consumed by this call (always 0 for contacts queries).

retryAfterinteger required

Seconds to wait before next call of the same type (always 0 for contacts queries).