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

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.

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 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

  1. [
  2. {
  3. "id": "a07e1ilbm7shdg6ikeo",
  4. "type": "REMOVE_CONTACTS_FROM_LISTS",
  5. "status": "COMPLETE",
  6. "start_date": "2013-02-21T17:23:09.812Z",
  7. "finish_date": "2013-02-21T17:23:09.837Z",
  8. "created_date": "2013-02-21T17:22:42.768Z",
  9. "error_count": 3,
  10. "contact_count": 3
  11. },
  12. {
  13. "id": "a07e1ilbm6uhdg5w1lu",
  14. "type": "REMOVE_CONTACTS_FROM_LISTS",
  15. "status": "COMPLETE",
  16. "start_date": "2013-02-21T17:06:11.800Z",
  17. "finish_date": "2013-02-21T17:06:11.849Z",
  18. "created_date": "2013-02-21T17:05:11.970Z",
  19. "error_count": 3,
  20. "contact_count": 3
  21. },
  22. {
  23. "id": "a07e1ilba2lhdf22eqb",
  24. "type": "EXPORT_CONTACTS",
  25. "status": "COMPLETE",
  26. "start_date": "2013-02-20T22:30:55.945Z",
  27. "finish_date": "2013-02-20T22:31:18.603Z",
  28. "created_date": "2013-02-20T22:30:24.275Z",
  29. "error_count": 0,
  30. "contact_count": 71296
  31. }
  32. ]
  33.