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

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

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

name

type

default

description

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 CodesTOP

code

description

200

Request was successful

400

Bad Request; Error in validating a contact

401

Authentication failure

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

[
	{
	"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
	}
]