Activities Status Report | Constant Contact Developer

Bulk Activity - Status Report Endpoint

Use this endpoint to generate a report showing the status of the last 50 bulk activities.

Methods:

Click a method to view its documentation

GET

Description TOP

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

Description TOP

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.

name	type	default	description
GET: https://api.constantcontact.com/v2/activities
api_key	query		REQUIRED; The API key for the application
status	query	ALL	Retrieve all activities with the specified status, valid values are: ALL (default) UNCONFIRMED PENDING QUEUED RUNNING COMPLETE ERROR
type	query		Retrieve all activities of the type specified; valid values are: ADD_CONTACTS REMOVE_CONTACTS_FROM_LISTS CLEAR_CONTACTS_FROM_LISTS EXPORT_CONTACTS

Response Codes TOP

code	description
200	Request was successful
400	Bad Request; Error in validating a contact
401	Authentication failure
500	Internal server error occurred

Structure TOP

property	type (max length)	description

Example Response TOP

[
	{
	"id": "a07e1ilbm7shdg6ikeo",
	"type": "REMOVE_CONTACTS_FROM_LISTS",
	"status": "COMPLETE",
	"start_date": "2013-02-21T17:23:09.812Z",
	"finish_date": "2013-02-21T17:23:09.837Z",
	"created_date": "2013-02-21T17:22:42.768Z",
	"error_count": 3,
	"contact_count": 3
	},
	{
	"id": "a07e1ilbm6uhdg5w1lu",
	"type": "REMOVE_CONTACTS_FROM_LISTS",
	"status": "COMPLETE",
	"start_date": "2013-02-21T17:06:11.800Z",
	"finish_date": "2013-02-21T17:06:11.849Z",
	"created_date": "2013-02-21T17:05:11.970Z",
	"error_count": 3,
	"contact_count": 3
	},
	{
	"id": "a07e1ilba2lhdf22eqb",
	"type": "EXPORT_CONTACTS",
	"status": "COMPLETE",
	"start_date": "2013-02-20T22:30:55.945Z",
	"finish_date": "2013-02-20T22:31:18.603Z",
	"created_date": "2013-02-20T22:30:24.275Z",
	"error_count": 0,
	"contact_count": 71296
	}
]