Individual Activity Status | Constant Contact Developer

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.

name	type	description
GET: https://api.constantcontact.com/v2/activities/{activity_id}
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 
}