Contact Activity Summary Report
Use this endpoint to retrieve a summary report of all email campaign activities (bounce, click, unsubscribe, forward, open, and send) for a specific contact.
Methods:
Click a method to view its documentation
Description TOP
Privileges required : campaign:read
Returns a summary of all activities (Sends, Opens, Clicks, Forwards, Unsubscribes, Bounces) for the email campaign specified by the
campaignId
path parameter. All data returned is current as of the last scheduled update, unless you set
updateSummary
=true, which will return updated data.
NOTE: Tracking information is only available for SENT email campaigns.
Description TOP
Privileges required : contacts:read
Retrieves a list of unsubscribe activities for the contact specified by the
contactId
path parameter (REQUIRED).
Use the
created_since
query parameter to retrieve only the unsubscribes that occurred on or after the date/time specified. This is useful for syncing tracking data across applications.
Description TOP
Privileges required : contacts:read
Retrieves a summary report of all activities for the contact specified by the
contactId
path parameter (REQUIRED).
Description TOP
Privileges required : contacts:read
Retrieves a list of all email campaign click activities for the contacts specified by the
contactId
path parameter (REQUIRED). Use the
created_since
query parameter to retrieve only activity that occurred on or after the date/time specified. This is useful for syncing tracking data across applications.
Description TOP
Privileges required : contacts:read
Retrieves a report of all email campaigns that were sent to the contact specified by the
contactId
path parameter (REQUIRED). Use the
created_since
query parameter to retrieve only the activity that occurred on or after the date/time specified. This is useful for sync'ing tracking data across applications.
Description TOP
Privileges required : contacts:read
Retrieves a summary report of the contact's (specified using the
contactID
path parameter) activities for each email campaign that has been sent to them, grouped by individual campaign. Unsubscribe activities are not included in this report.
Description TOP
Privileges required : contacts:read
Retrieves a report showing all email campaigns that bounced when sent to the contact specified by the
contactId
path parameter.
Bounce reasons
See this FAQ that details the types of bounces we track.
Description TOP
Privileges required : contacts:read
Retrieves a report of a contact's (specified by the
contactId
path parameter) activities for all email campaigns that have been sent to them. Activities are listed in order of the newest to the oldest.
|
GET: https://api.constantcontact.com/v2/contacts/{contactId}/tracking/reports/summary |
|||
|
name |
type |
default |
description |
|---|---|---|---|
|
api_key |
query |
|
REQUIRED; The API key for the application |
|
contactId |
path |
|
Specifies the contact to retrieve an events summary for |
Response Codes TOP
|
code |
description |
|---|---|
|
200 |
Request was successful |
|
401 |
Authentication failure |
|
404 |
The specified campaignId was not found |
|
406 |
Unsupported accept header value, must be application/json |
|
500 |
Internal server error occurred |
Structure TOP
|
property |
type (max length) |
description |
|---|
Example Response TOP
{
"sends": 15,
"opens": 10,
"clicks": 10,
"forwards": 3,
"unsubscribes": 2,
"bounces": 18,
"contact_id": "11"
}