Skip to main content
GET
Count an account's people

Authorizations

X-API-Key
string
header
required

Path Parameters

account_key
string
required

The account's key: its domain (acme.com), or its LinkedIn page (li-co:acme).

Required string length: 1 - 320
Pattern: ^(?:[^/.][^/]*|\.[^/.][^/]*|\.\.[^/]+)$

Query Parameters

search
string | null

Text found in the person's name, title or address.

Maximum string length: 255
seniority
(enum<string> | string)[]

Only people whose title's seniority is one of these, or none for no title; repeat for several.

Maximum array length: 8

How senior a person's title says they are (review AC-12). None: no title.

Read off the title's words by a fixed rule (org_chart.title_seniority): a title with no rank word in it is OTHER, never guessed at.

Available options:
executive,
vp,
head,
director,
manager,
senior,
other
department
(enum<string> | string)[]

Only people whose title names one of these departments, or none for a title naming none; repeat for several.

Maximum array length: 14

The part of a company a person's title names (review AC-12). None: it names none.

Read off the title's words by a fixed rule (org_chart.title_department).

Available options:
sales,
marketing,
customer_success,
product,
design,
engineering,
data,
it,
security,
finance,
people,
operations,
legal
title
string[]

Only people with one of these titles, whole and in any case (none for no title), as GET .../people/facets/ names them; repeat for several.

Maximum array length: 100
Maximum string length: 255
role
(enum<string> | string)[]

Only people a rep gave one of these roles on the org chart, or none for no role; repeat for several.

Maximum array length: 7

The part a rep says a person plays in a deal. None: not known.

Available options:
champion,
budget_holder,
decision_maker,
influencer,
user,
blocker
email_status
(enum<string> | string)[]

Only people whose address is one of these (a Verify email column's verdict, or bounced), or none for an address nothing checked; repeat for several.

Maximum array length: 8

What is known of a person's address (review AC-12). None: nothing checked it.

The verdict of the Verify email column over the address on their row, the words that column writes; BOUNCED when an email to them bounced, whatever a check said.

Available options:
valid,
catch_all,
risky,
unknown,
invalid,
disposable,
bounced
namesake
enum<string>[]

Only people another person at the account goes by the same name as: likely_same when nothing tells them apart (likely one person found twice), same_name when each has a LinkedIn profile of their own or the name is short of a full one. A person with both kinds among their namesakes is kept by either; repeat for both.

Maximum array length: 2

What another person at the account going by the same name is to someone (review AC-19).

Names match as their words, case, accents and punctuation gone. LIKELY_SAME: a full name (two words or more, none a lone letter) and nothing tells them apart (at most one of them has a LinkedIn profile), so they are likely one person found twice, as a merge leaves them. SAME_NAME: each has a LinkedIn profile of their own, so they are two people, or the name is short of a full one, which says too little. A placeholder ("LinkedIn Member") is no name, and names no namesakes.

Available options:
likely_same,
same_name
table
string<uuid>[]

Only people with a row on one of these tables, by id (a table card's View all); repeat for several.

Maximum array length: 100

Response

Successful Response

How many people at an account the People tab's search and filters keep.

count
integer
required