GetContactImportReportFaults

Gets all contact import records that were not successfully imported

This method returns all contact records that failed import. The data is returned in a CSV file, which is UTF-8 encoded. This data will only be available for approximately one week after import.

Reasons for failure can be:

  • 'Globally Suppressed' - The contact is on the Global Suppression List (GSL) because they have either complained directly to us in the past or are known spam traps
  • 'Invalid Email' - The contact's email address is invalid
  • 'Duplicate' - The contact's email address is duplicated elsewhere
  • 'Blocker' - The contact's email address is blocked because they've previously received messages that their provider does not want to process, possibly because of attachments
  • 'Unsubscribed' - The contact is unsubscribed
  • 'Hard bounced' - The contact's email address is permanently unreachable, most likely because they, or the server they were hosted on, do not exist
  • 'Soft bounced' - The contact's email address is temporary unavailable, possibly because their mailboxes are full or their server is having temporary issues accepting mail
  • 'Complained to ISP' - The contact has submitted spam complaints to us via their ISP
  • 'Mail blocked' - The contact's mail server has indicated that it doesn’t want to receive mail
  • 'Suppressed by Domain' - The contact's email address belongs to a domain you've previously added to your suppression list
  • 'Pending optin' - The contact is currently pending double opt-in confirmation
  • 'Failures' - The contact's email address has failed to import for a reason other than listed above

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

📘

Input and output parameters

The input and output parameters for this method are:

Input parameters

  • Import ID - required; GUID

Output parameters

  • GetContactImportReportFaultsResult

Example

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

	var path = "report-faults.csv";
	var importId = new Guid("00000000-0000-0000-0000-000000000000"); // Should be obtained from the status of a previous import
	var reportFaults = client.GetContactImportReportFaults(importId);
	File.WriteAllBytes(path, reportFaults);
}