Skip to main content
GET
What this person actually did, newest first, to the microsecond.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

personId
string
required

Query Parameters

companyId
string

Company ID. Required for PAK/API key auth; optional for JWT auth.

page
integer
default:1

1-indexed page number

pageSize
integer
default:50

Events per page. Default 50, max 200.

eventTypes
string

Comma-separated event types to include. Any of: open, click, schedule_view, schedule_booking, status_change, voice_call_completed. Omit for all.

includeBots
boolean
default:false

Include events attributed to scanners and mail-proxy prefetchers (Microsoft Safe Links, GoogleImageProxy, etc.). Excluded by default because they are not human actions.

Response

Paginated engagement timeline for one person

Paginated person activity timeline

botCount
integer

Bot events excluded from (or included in) this filter set

items
object[]

Events, newest first

page
integer

Current page

pageSize
integer

Events per page

total
integer

Total events matching the current filters

truncated
boolean

True when the person has more events than one scan covers, so older history is omitted