Get contacts activity

The method returns the contact activity on subscriptions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
šŸ“˜

Note

The method is enabled on request — contact support to activate it for your account. Activation can take a few hours. Activity data starts accumulating from the moment the feature is enabled and is stored for 90 days.

šŸ“˜

Note

Use this endpoint with the email filter together with messageTag and/or activityStatus to check whether a specific transactional message has already been sent to a contact within a given period — for example, before sending a follow-up so you don't duplicate it. If activity for the message tag and status you're checking is already present in the response, skip the send.

šŸ“˜

Note

dateFrom and dateTo values without a time part mean midnight UTC of that date. To include activity from the current day, specify the time in ISO 8601 format — for example, dateTo=2026-05-29T10:59:59.

Query Params
string
required

Initial date and time of the period you want to get the contact activity for

string
required

Final date and time of the period you want to get the contact activity for

string

Email address

string

Contact's phone number

string

Web Push token

string

Mob Push token

string

Telegram token

string

Message tag

string
enum

Activity status (DELIVERED, UNDELIVERED, READ, UNSUBSCRIBED, CLICKED, SPAM)

Allowed:
string

Last found contact activity offset in previous search results. It is used to continue search

int32
Defaults to 25000

Max number of activity entries in response

Response

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json