Our v3 API is now available! Learn more by visiting the v3 developer portal. Creating new v2 API keys is no longer supported.

Contact Activity Detailed Report

Use this endpoint to retrieve a detailed report of all activities for all campaigns sent to a contact.

Methods:

Click a method to view its documentation

GET

DescriptionTOP

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.

DescriptionTOP

Privileges required: contacts:read

Retrieves a summary report of all activities for the contact specified by the contactId path parameter (REQUIRED).

DescriptionTOP

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.

DescriptionTOP

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.

DescriptionTOP

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. 

DescriptionTOP

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. 

DescriptionTOP

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

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

contactId

path

Specifies the contact to retrieve all activities for

created_since

query

Use to retrieve only activities that occurred on or after the date/time specified in ISO-8601 format.

limit

query

500

Specifies the number of results displayed per page of output, from 1 - 500, default = 500.

See Paginated Output for more information on using limit.

Response CodesTOP

code

description

200

Request was successful

401

Authentication failure

404

contact id not found

406

Unsupported accept header value, must be application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

{
  "meta": {
     "pagination": {
	   "next_link": "/v2/contacts/1/tracking?next=c3RhcnRBdD0zJmxpbWl0PTI"
			        }
    },
    "results": [
      {
          "activity_type": "EMAIL_UNSUBSCRIBE",
          "campaign_id": "1100394165287",
          "contact_id": "1",
          "email_address": "xyz@example.com",
          "unsubscribe_date": "2013-03-15T14:55:17.103Z",
          "unsubscribe_source": "ACTION_BY_CONTACT",
          "unsubscribe_reason": "No longer use this product and service"
      },
      { 
          "activity_type": "EMAIL_FORWARD",
          "campaign_id": "1100394165287",
          "contact_id": "1",
          "email_address": "xyz@example.com",
          "forward_date": "2013-02-08T10:32:20.554Z" 
      },    
      {
          "activity_type": "EMAIL_CLICK",
          "campaign_id": "1100394165287",
          "contact_id": "1",
          "email_address": "xyz@example.com",
          "link_id": "1100394165682",
          "link_uri": "http://www.example.com",
          "click_date": "2013-02-06T09:32:30.236Z"
      },      
      {
          "activity_type": "EMAIL_OPEN",
          "campaign_id": "1100394165287",
          "contact_id": "1",
          "email_address": "xyz@example.com",
          "open_date": "2013-02-06T08:06:30.641Z"
      },
      {
          "activity_type": "EMAIL_SEND",
          "campaign_id": "1100394165287",
          "contact_id": "1",
          "send_date": "2013-02-06T18:31:00.000Z"
      },
      {
          "activity_type": "EMAIL_BOUNCE",
          "campaign_id": "1100394165290",
          "contact_id": "1",
          "email_address": "abc@example.com",
          "bounce_code": "B",
          "bounce_description": "Non-existent address",
          "bounce_message": "",
          "bounce_date": "2012-12-06T18:06:39.990Z"
      },
      {
          "activity_type": "EMAIL_SEND",
          "campaign_id": "1100394165290",
          "contact_id": "1",
          "send_date": "2012-12-06T13:31:00.000Z"
      }
    ]
}