Returns the values a brand's events hold for the given event properties,
using cursor paging.
Filtering:
eventName and eventOrigin are both required and select the event to read:
values are stored per origin, so a read always covers a single one.
properties names 1-10 property paths to read the values of, such as
contact.email or order.currency.
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
Values:
Only the string leaves of an event payload are collected, so numbers,
booleans, objects and arrays have no values to return. A property path
that was never collected is not an error: it is returned as an empty
array. The response echoes eventName and eventOrigin the values belong
to.
Paging:
limit (1-1000, default 100) caps the page size and counts the values of
all requested properties together. after continues a previous page and
must be sent with the same filters that page was read with. Values are
grouped per property and ordered alphabetically inside 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.