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

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/{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 Codes TOP

code

description

200

Request was successful

400

Bad Request; Error in validating a contact

401

Authentication failure

500

Internal server error occurred

Example Response TOP

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