Skip to main content
GET
List People

Query parameters

Substring match across email, first name, last name, company.
string
Exact match. One of identified, aware, interested, evaluating, client.
string
Exact match on the entity’s source claim.
string
Entity status. active (default) or archived.
boolean
Restrict to people who do or do not have an email identifier.
boolean
Restrict to people who do or do not have a LinkedIn URL.
string
Duration like 2d, 7d, 30d. Returns people whose last activity was before now minus the duration, including people who never had activity. Use this for the “gone quiet for N” filter inside a morning loop.
string
Duration like 2d, 7d, 30d. Returns people active within the window.
string
last_activity_desc (default) or last_activity_asc.
integer
default:"100"
Page size. Max 1000.
integer
default:"0"
Page offset.

Response

id is the entity UUID. Pass it to GET /v2/accounts/:id, POST /v2/context, POST /v2/observations — anywhere the v2 surface accepts a focus. (POST and PATCH responses include both id and entity_id; they always carry the same value.)