Skip to main content
GET
List person events

Authorizations

X-API-Key
string
header
required

API key in format: mk_live_{40 hex chars}

Path Parameters

id
string
required

Person ID

Query Parameters

limit
integer
default:50

Number of records per page

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from the previous response's nextCursor

event_type
string

Return only events of this type. Accepts any string, including event types introduced after this document was written.

domain
string

Partner accounts only. Restrict results to one tracked client domain. Matches subdomains too, so acme.com includes app.acme.com. A domain-scoped API key cannot use this to reach beyond its own scope.

client_ref
string

Partner accounts only. Restrict results to one client by the reference label set on its tracked domains. Case-insensitive. If a client has several domains registered, all of them are included.

domain_group_id
string

Partner domain group ID. Matches exact member hostnames (www aliases normalized), including any member site the person has visited. Intersects domain, client_ref, and the key's scope; never grants extra access. Empty group returns zero matches; missing/foreign group returns 404; invalid ID returns 400. Keep this filter when following pagination cursors.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

Response

List of events

person
object

Summary of the person these events belong to

data
object[]
pagination
object