Skip to main content
GET
List people
People are created by activity from your connected tools, so this group is read-only. By default the list holds the people your workspace has engaged. Add include=all for everyone, cold leads included.
This list keeps its own page size, default 100 and max 1000. With include=all it follows the usual 50 and 200. pipeline_stage takes a standard stage.

Authorizations

Authorization
string
header
required

Workspace API key. Create one in Settings → API keys.

Query Parameters

Substring match on email, first name, last name, company, and LinkedIn URL.

pipeline_stage
enum<string>

Exact stage.

Available options:
identified,
connected,
interested,
meeting_booked,
discovery,
demo,
negotiation,
closed_won,
closed_lost,
disqualified,
churned
source
string

Exact match on the person's source.

status
string

Exact match on the person's status.

email
string

Exact email match, case-insensitive.

linkedin_url
string

Exact LinkedIn URL match. Trailing slash and www variants match.

has_email
enum<string>

Only people with, or without, an email.

Available options:
true,
false
has_linkedin
enum<string>

Only people with, or without, a LinkedIn URL.

Available options:
true,
false
icp_fit
enum<string>

Only ICP fits (score 70 or higher), or only non-fits.

Available options:
true,
false
min_icp_score
integer

Minimum ICP score.

Required range: 0 <= x <= 100
last_activity_after
string

Active within this window, for example 7d.

Pattern: ^\d+[smhd]$
last_activity_before
string

Quiet for at least this long, for example 30d. Includes people with no activity.

Pattern: ^\d+[smhd]$
account
string

Only people at one account. Entity UUID or domain.

include
enum<string>

all lists everyone, cold leads included. With all, only search, pipeline_stage, email, has_email, icp_fit, min_icp_score, last_activity_before, last_activity_after, account, and sort (not recently_added) are supported, and the page size defaults to 50, max 200.

Available options:
all
sort
enum<string>
default:last_activity

Sort order. Unknown values return 400.

Available options:
last_activity,
last_activity_asc,
icp_score,
icp_score_asc,
recently_added
limit
integer
default:100

Page size.

Required range: 1 <= x <= 1000
offset
integer
default:0

Rows to skip. Wins over page.

Required range: x >= 0
page
integer

1-based page number. Used when offset is not set.

Required range: x >= 1

Response

A page of people.

people
object[]
limit
integer
offset
integer
has_more
boolean