---
title: "Get contacts activity"
method: GET
path: "/api/v2/contacts/activity"
tags: ["Behavior tracking"]
---

# Get contacts activity

`GET /api/v2/contacts/activity`

The method returns the contact activity on subscriptions.

## Query parameters

- `dateFrom` string, required
- `dateTo` string, required
- `email` string
- `sms` string
- `webPushToken` string
- `mobPushToken` string
- `telegramToken` string
- `messageTag` string
- `activityStatus` 'DELIVERED' | 'UNDELIVERED' | 'READ' | 'UNSUBSCRIBED' | 'CLICKED' | 'SPAM'
- `offset` string
- `maxrows` integer

## Response `200`

- ContactActivity[]
  - `iid` string — ID of the sent message.
  - `externalRequestId` string — External request ID.
  - `contactId` integer — Contact ID.
  - `externalCustomerId` string — External contact ID.
  - `email` string — Contact's email address.
  - `webPushToken` string — Web push token.
  - `mobPushToken` string — Mob push token.
  - `sms` string — Contact's phone number.
  - `mediaType` 'email' | 'sms' | 'viber' | 'mobilepush' | 'webpush' | 'appinbox' | 'widget' | 'inapp' | 'telegrambot' — Media type: Email, SMS, Viber.
  - `activityStatus` string — Activity status<br/><br/> <b>DELIVERED</b> - message delivered<br/> <b>UNDELIVERED</b> - message not delivered<br/> <b>READ</b> - message read<br/> <b>UNSUBSCRIBED</b> - contact unsubscribed from mailing<br/> <b>SUBSCRIPTION_CHANGED</b> - contact changed subscription categories<br/> <b>CLICKED</b> - contact followed the links in the message<br/> <b>SPAM</b> - contact complained about spam
  - `messageId` integer — Message ID.
  - `messageInstanceId` integer — Message instance ID.
  - `messageName` string — Message name.
  - `messageTag` string — Email message label.
  - `activityDateTime` string — Activity date and time.
  - `statusDescription` string — This field is returned only if the status is UNDELIVERED,<br/> Contains the cause of the delivery failure.<br/> This may be a response from the recipient's server, a system's response about inability to send the message, etc.
  - `viewMessageLink` string — Contains a link to the message. For emails only.
  - `clickEventLink` string — Contains the link clicked by the contact.
  - `subscriptions` string[] — Subscription category keys
  - `offset` string — Contains the bias result. Used to continue the previous search.
  - `messageLanguageCode` string — Message language code.
  - `sourceEventKey` string — Source event key.
  - `sourceEventTypeKey` string — Source event type key.
  - `workflowBlockId` string — Workflow block ID.
  - `workflowId` integer — Workflow ID.
  - `workflowInstanceId` string — The ID of a particular workflow launch.
  - `broadcastId` integer — Broadcast ID.
  - `from` string — Sender
  - `telegramToken` string — TelegramToken
  - `osType` string — Device operation system type. Possible values: Desktop, Mobile.
  - `osName` string — Device operation system name. Example values: Windows NT, iOS, Mac OS.
  - `imid` integer — Immediate message id.

---

[API](https://skmtc.net/esputnik/apis/esputnik-com.md) · [All operations](https://skmtc.net/esputnik/apis/esputnik-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esputnik/esputnik-com/revisions/1c4afd7ba72a/schema)