GetSuppressedContacts

Gets a list of suppressed contacts after a given date along with the reason for suppression

This method can be used to a retrieve a list of contacts who have been suppressed in your account after a specified date, giving a reason for their suppression.

Please note that contact data field details are not returned in the results for suppressed contacts.

The possible suppression reasons can be:

  • 'Unsubscribed' - The contact is unsubscribed from your communications
  • 'SoftBounced' - The contact’s address is temporarily unavailable, possibly because their mailbox is too full, or their mail server won’t accept a message of the size sent, or their server is having temporary issues accepting any mail
  • 'HardBounced' - The contact’s address is permanently unreachable, most likely because they, or the server they were hosted on, does not exist
  • 'IspComplained' - The contact has submitted a spam complaint to us via their internet service provider
  • 'MailBlocked' - The mail server indicated that it didn’t want to receive the mail. No reason was given
  • 'DirectComplaint' - The contact has complained directly to either us, a hosting facility or possibly even a blacklist about receiving your communications
  • 'Suppressed' - The contact that has been actively suppressed by you in your account
  • 'NotAllowed' - The contact's email address is fully blocked from our system
  • 'DomainSuppression' - The contact’s email domain is on your domain suppression list
  • 'NoMxRecord' - The contact’s email domain does not have an MX DNS record. A mail exchange record provides the address of the mail server for that domain.

The select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request.

The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set.

SOAP action: http://apiconnector.com/v2/ApiService/GetSuppressedContacts

📘

Input and output parameters

Input parameters

  • StartDate - required; dateTime
  • Select - optional; integer
  • Skip - optional; integer

Output parameters

  • GetSuppressedContactsResult - array of ContactSuppression
    • ContactSuppression
      • SuppressedContact
        • Id - integer
        • Email - string
        • OptInType - string ('Unknown', 'Single', 'Double', 'VerifiedDouble')
        • EmailType - string ('PlainText', 'Html')
        • Status - string ('Subscribed', 'Unsubscribed', 'SoftBounced', 'HardBounced', 'IspComplained', 'MailBlocked', 'PendingOptIn', 'DirectComplaint', 'Deleted', 'SharedSuppression', 'Suppressed', 'NotAllowed', 'DomainSuppression', 'NoMxRecord')
      • DateRemoved - dateTime
      • Reason - string ('Subscribed', 'Unsubscribed', 'SoftBounced', 'HardBounced', 'IspComplained', 'MailBlocked', 'PendingOptIn', 'DirectComplaint', 'Deleted', 'SharedSuppression', 'Suppressed', 'NotAllowed', 'DomainSuppression', 'NoMxRecord')

Example

using (var client = new ApiServiceClient())
{
	client.ClientCredentials.UserName.UserName = "username";
	client.ClientCredentials.UserName.Password = "password";

	var startDate = new DateTime(2020, 01, 01, 00, 00, 00, DateTimeKind.Utc);
	var select = 1000;
	var skip = 0;
	var suppressions = client.GetSuppressedContacts(startDate, select, skip);
}