List Contacts

GET

/contacts

Production
QA

List contacts with optional filtering and pagination.

Authorizations

BearerAuth

Parameters

Query Parameters

page

Page number (1-indexed)

integer

default: 1 >= 1

Page number (1-indexed)

limit

Items per page (max 200)

integer

default: 50 >= 1 <= 200

Items per page (max 200)

email

Any of:

string
null

string

Filter by work email (exact match, case-insensitive; surrounding spaces ignored)

list_id

Any of:

integer
null

integer

Filter by list ID

name

Any of:

string
null

string

Filter by first or last name (partial match)

job_title

Any of:

string
null

string

Filter by job title (partial match)

seniority_level

Any of:

string
null

string

Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. VP (or Vice President) means VP and above, so it also returns the SVP/EVP band; SVP/EVP alone returns only that band. Pass several levels comma-separated to match any of them, e.g. Director,VP.

company_name

Any of:

string
null

string

Filter by company name (partial match)

company_id

Any of:

integer
null

integer

Filter by company ID

country

Any of:

string
null

string

Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK.

state

Any of:

string
null

string

Filter by state (exact match, case-insensitive; surrounding spaces ignored)

city

Any of:

string
null

string

Filter by city (partial match)

job_department

Any of:

string
null

string

Filter by job department (partial match)

industry

Any of:

string
null

string

Filter by company industry (partial match)

include_custom_fields

When true, each contact includes a custom_fields object of custom column values keyed by column slug. Default false keeps the legacy response shape and adds no extra query.

boolean

When true, each contact includes a custom_fields object of custom column values keyed by column slug. Default false keeps the legacy response shape and adds no extra query.