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)

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)

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)

state

Any of:

string
null

string

Filter by state (exact match)

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.