Returns the events of the given contacts for a single event name, using
cursor paging.
Filtering:
contactIDs (1-100) names the contacts to read, and eventName selects the
event, returning every origin the brand has data for, limited to Omnisend's
standard events. eventOrigin narrows the result to a single origin, and
from/to define a begin-inclusive, end-exclusive time window.
Supported events:
eventName accepts one of the standard events below; brand-custom events
are not readable.
subscribed to marketingunsubscribed from marketingopted-in for promotionsopted-out from promotionsmessage sentopened messageclicked messagemarked message as spammessage delivery failed
Paging:
limit (1-1000, default 100) caps the page size. after continues a previous
page and must be sent with the same filters that page was read with.
Results are grouped per contact, and per origin within a contact, and are
ordered newest first inside such a group rather than across the page.
Paging is forward-only, so paging.cursors.after is null on the last page.
Scopes:
events.read
Rate Limiting:
This endpoint is rate limited to 20 requests per minute.