List People
People
List People
Filtered, paginated list of people in the workspace. Workflow shape — same projection your agent sees through /v2/accounts/:id.
GET
List People
Query parameters
string
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.)