REST Email Marketing API Documentation

MAILINGS — CHECKQUEUERESULTS

If the call to queue a mailing didn't give the results within the timeout, you can call this function to get the final results. Once you get results once they are not returned again. Only mailings that didn't return the results immediately after the queue will return results with this function.

HTTP VERB

Get

URL

/API/Rest/Mailings/CheckQueueResults

ARGUMENTS

mailingTitle

Required permission

QueueMailing

ERRORS

Empty results means there is nothing to report.
No Permission
Invalid mailing title
Too many API calls
Database error
Unknown error

RETURNS

A structure with fields for the different exclusions. The total recipients that were queued for the mailing is the totalRecords minus each of the exclusions.

{"totalHeldMembers":6261, "totalUnconfirmedMembers":3201, "totalUnsubscribedMembers":99, "totalRecencyMembers":0, "totalSuppressedMembers":0, "fccBans":0, "totalRecords":25510}

EXAMPLE

Get the details for one specific mailing.

string url = "http://example.com/api/rest/Mailings/CheckQueueResults/?accountName=acme&login=ApiUser&mailingTitle=Test1";
							
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://example.com/api/rest/Mailings/CheckQueueResults/?accountName=acme&login=ApiUser&mailingTitle=Test1'
response = RestClient.get(url, "", {:Password => "sfhdf6df5fdy"})
puts response

import requests

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

http://example.com/api/rest/Mailings/CheckQueueResults/?accountName=acme &login=ApiUser &password=sdff34fg34s &mailingTitle=Test1