Skip to main content
GET
Get all contacts with pagination and filtering
Retrieve contacts with optional pagination, search, and filtering.

Authorizations

Authorization
string
header
required

API key from Settings → API. Send it as Authorization: Bearer .

Headers

x-impersonate-user-id
string

ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.

Query Parameters

page
number

Page number (starts from 1)

limit
number

Number of contacts per page (default: 20)

Search term for firstName, lastName, email, company, website, location, or jobTitle

agent
string

Filter by agent id

dateFrom
string

Filter contacts created from this date (YYYY-MM-DD or YYYY-MM-DDTHH:MM)

dateTo
string

Filter contacts created until this date (YYYY-MM-DD or YYYY-MM-DDTHH:MM)

scoreFrom
number

Filter contacts with total scoring >= this value (0-3 range)

scoreTo
number

Filter contacts with total scoring <= this value (0-3 range)

intentType
string

Filter contacts with intent type

listId
number

Filter contacts by list id

Response

200 - application/json

List of contacts with pagination information

contacts
object[]
total
number

Total number of contacts

page
number

Current page number

limit
number

Number of contacts per page

totalPages
number

Total number of pages