Email Campaign Bounces Report

Use this endpoint to retrieve a list of email addresses that bounced for a sent email campaign. This information should be used by Constant Contact users to manage their contacts by including valid email addresses in their contact lists. See this FAQ to learn how manage your lists to minimize the number of bounces for your campaigns.

Methods:

Click a method to view its documentation

GET

DescriptionTOP

Privileges required: contacts:read

Retrieves a list of all link clicks for the campaign specified by the campaignId path parameter (REQUIRED). Use the created_since query parameter to retrieve only the clicks that occurred on or after the date/time specified. This is useful for syncing tracking data across applications.

NOTE: Tracking information is only available for SENT email campaigns.

GET: https://api.constantcontact.com/v2/emailmarketing/campaigns/{campaignId}/tracking/bounces

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

campaignId

path

Specifies the email campaign to retrieve tracking data for

created_since

query

Use to retrieve only email campaign bounces that occurred on or after the date/time specified in ISO-8601 format.

limit

query

500

Specifies the number of results displayed per page of output, from 1 - 500, default = 500. See Paginated Output for more information on using limit.

Response CodesTOP

code

description

200

Request was successful

401

Authentication failure

404

Campaign ID not found

406

Unsupported accept header value, must be application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

activity_type

string

Campaign activity type, always EMAIL_BOUNCE for this report

bounce_code

string

Email bounce code, valid values are B, D, F, S, V, X, Z, see bounce_description for definitions

bounce_date

string

Date the email message bounced

bounce_description

string

bounce_code descriptions:

  • B - Non-existent address; the contact's Internet Service Provider (ISP) says that the email address doesn't exist.
  • D - Undeliverable; no response from the ISP, delivery is attempted for 3 day total.
  • F - Full; recipient's mailbox is full.
  • S - Suspended; recipient address has been reported as non-existent by the ISP, and is suspended from delivery. The user should remove the contact from their account.
  • V - Vacation/autoreply; recipient has set an autoreply, but the message was delivered.
  • X - Other; the contact's ISP has specified another reason the message cannot be delivered.
  • Z - Blocked; the recipient's ISP has decided not to deliver it, likely because it thought the email was spam.

bounce_message

string

System message provided for the bounce

campaign_id

string

Unique ID of the email campaign in which the bounce occurred

contact_id

string

Specifies the contact whose email address bounced

email_address

string

Email address that bounced

Example ResponseTOP


{
    "meta": {
        "pagination": {
            "next_link": "/v2/emailmarketing/campaigns/1100388730957/tracking/bounces?next=c3RhcnRBdD0zJmxpbWl0PTI"
        }
    },
    "results": [
        {
            "activity_type": "EMAIL_BOUNCE",
            "campaign_id": "1100388730957",
            "contact_id": "1159",
            "email_address": "user1@example.com",
            "bounce_code": "B",
            "bounce_description": "Non-existent address",
            "bounce_message": "",
            "bounce_date": "2009-11-25T09:29:28.406Z"
        },
        {
            "activity_type": "EMAIL_BOUNCE",
            "campaign_id": "1100388730957",
            "contact_id": "1161",
            "email_address": "user2@example.com",
            "bounce_code": "B",
            "bounce_description": "Non-existent address",
            "bounce_message": "",
            "bounce_date": "2009-12-02T09:34:26.382Z"
        }
       
     ] 
}