Get contacts activity

Returns activity records for the messages sent to your contacts over the period you specify. Each record carries a status — DELIVERED, UNDELIVERED, READ, CLICKED, UNSUBSCRIBED, SUBSCRIPTION_CHANGED, or SPAM — the time it happened, and the message and contact it belongs to. For UNDELIVERED, the reason is returned as well.
Use it to bring message statuses, contact actions, and delivery failures into your own system. Read more...

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 the email filter (plus a message-tag or status filter, if available) to check whether a given transactional message was already sent to a contact — this helps avoid duplicate sends.

📘

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