REST Email Marketing API Documentation

COMPLAINTS

When configured properly, Symphonie will receive a "complaint" from the Internet Service Providers (ISPs) that indicates the recipient hit the "This is spam" or similar worded item. You can use this API call to determine if a specific email address has complained, or to find all email addresses that complained in a time period.

Recipients who complain are automatically put on the global unsubscribe list to prevent them from receiving any further email.

HTTP VERB

Get

URL

/API/Rest/Complaints

ARGUMENTS

EmailAddress (optional)
StartTime (optional)
EndTime (optional)

Required permission

StandardReports

ERRORS

Email address not found in the database
No Permission
Invalid login data
Database error
Unknown error

RETURNS

There could be thousands of rows, so the data is returned with an optional "Fetch-more GUID". The basic data is the email address and the time of the complaint.
{"downloadGuid":"b76e981d-cc7e-4d94-8be0-b599b314ca77","totalRows":3,"userData":[["IComplain@aol.com","7/6/2012 6:28 PM"],["NoMail@aol.com","9/6/2013 3:56 AM"],["TiredOfMail@aol.com","7/9/2013 2:10 PM"]]}

EXAMPLE

This example fetches all complaints, across all time.

string url = "http://example.com/api/rest/Complaints?accountName=acme&login=ApiUser";

try
{
  System.Net.HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
  request.Headers.Add("Password", "34teh6i6j565ydw4h");
  using (System.Net.WebResponse response = request.GetResponse())
    using (Stream responseStream = response.GetResponseStream())
      using (StreamReader reader = new StreamReader(responseStream, Encoding.UTF8))
        System.Console.WriteLine(reader.ReadToEnd());
}
catch (System.Net.WebException ex)
{
  System.Diagnostics.Debug.Fail(ex.Message);
}
						

# encoding: utf-8
require 'rest-client'
require 'json'
url = 'http://www.example.com/api/rest/Complaints?accountName=Acme&login=ApiUser'
response = RestClient.get(url, {:Password=>'sfhdf6df5fdy'})
puts response
						

import requests
url = "http://www.example.com/api/rest/Complaints?accountName=Acmet&login=ApiUser";
headers = {'password':'sfhdf6df5fdy'}
resp = requests.get(url, headers=headers)
if resp.status_code == 200:
	print resp.text