Get daily engagement events
Return retained raw open and click event counts by UTC day, scoped to the credential's environment. Each kind has total, likely, unlikely, and unknown automation buckets. Repeated events count separately; these are not unique people or the recipient-capped rollup counters/rates. Unknown includes older events without metadata and remains when excluding likely automation (total minus likely). No bucket proves a human action or Inbox placement. Days without events are omitted. Bounds are inclusive real calendar dates. Omitted to defaults to today's UTC date; omitted from to 30 days before today, independently of to. Rejects future to, reversed windows, and more than 93 inclusive days before retention clamping. Retention uses an exact timestamp, so the first retained day may be partial; an entirely expired window returns an empty data array. Requires read:analytics. A failed or timed-out read is an error, not zero events.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Inclusive lower bound as a YYYY-MM-DD day. Defaults to 30 days ago and is always clamped up to the plan retention floor.
Inclusive upper bound as a YYYY-MM-DD day. Defaults to the current UTC day.
Response
Sparse daily raw event counts.
dataarray<object>requireddata.daystring<date>requiredUTC event day; the first retained day may be partial.
data.opensobjectrequiredRaw event counts; total equals likely plus unlikely plus unknown.
data.clicksobjectrequiredRaw event counts; total equals likely plus unlikely plus unknown.