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

Individual Activity Status Endpoint

Use this endpoint to retrieve a status report for a specific activity. Bulk activities are each stored for 14 days. After that, they are deleted and you will receive a 404 trying to retrieve them.

Methods:

Click a method to view its documentation

GET

DescriptionTOP

Privileges required: contacts:write OR contacts:read

Retrieve a summary status report of the last 50 activities submitted. Individual activities are stored for 14 days.

You can filter the response as follows:

  • by type
  • by status
  • by both status and type

DescriptionTOP

Privileges required: contacts:write OR contacts:read

Retrieve a detailed status report for an activity specified by activityId path parameter. The URI to call with the activityId is returned in the bulk activity response's location header:

Location: https://api.constantcontact.com/v2/activities/<activityId>

Poll this URI to monitor the status until the status changes to either COMPLETE or ERROR, indicating that the activity processing is complete.

GET: https://api.constantcontact.com/v2/activities/{activity_id}

name

type

default

description

activity_id

path

Specifies the bulk activity to retrieve status for

api_key

query

REQUIRED; The API key for the application

Response CodesTOP

code

description

200

Request was successful

400

Bad Request; Error in validating a contact

401

Authentication failure

500

Internal server error occurred

Example ResponseTOP

{ 
  "id": "328177e0-4603-11e5-9d88-00163e56be7c", 
  "type": "ADD_CONTACTS", 
  "status": "COMPLETE", 
  "file_name": "upload_from_json.csv", 
  "start_date": "2015-08-18T23:45:30.000Z", 
  "finish_date": "2015-08-18T23:45:33.000Z", 
  "created_date": "2015-08-18T23:45:25.000Z", 
  "error_count": 2, 
  "errors": [ 
    "Line 2: Invalid birthday", 
    "Line 3: Invalid birthday" 
  ], 
  "contact_count": 3 
}