REST Email Marketing API Documentation

MAILINGS — REPORT

Provide data about open, clicks, complaints, or deliverability for a specific mailing.

HTTP VERB

Get

URL

/API/Rest/Mailings/Report

ARGUMENTS

mailingTitle
reportType

Required permission

StandardReports

ERRORS

No Permission
Invalid report type. Options: Clicks, Opens, Deliverability, Complaints
Invalid mailing title
Error in processing
Too many API calls
Database error
Unknown error

RETURNS

Details for the mailing. Each of the reports returns the email address, name field, and the date of the activity. Each of the repots varies slightly. The Deliverability report has the status of the send attempt. The Clicks report includes the URL and the alias for the URL, if specified.

Clicks
Email Address Name URL Timestamp URL alias


		{"downloadGuid":"d2746c93-1e91-4e7f-b417-71586f6969ba","totalRows":7, 

		"userData":[["kent@aol.com","Kent Example","https://www.example.com/gdpr","5/2/2018 2:47 PM",""], 

		["wayne@att.net","","https://www.example.com/gdpr","5/2/2018 4:07 PM",""], 

		["eddie@aol.com","Eddie Example","https://www.example.com/gdpr","5/3/2018 12:58 AM",""], 

		["aaron@msn.com","Aaron Example","https://www.example.com/gdpr","5/3/2018 3:06 AM",""], 

		["Joe@aol.com","Joe Example","https://www.example.com/gdpr","5/3/2018 5:49 AM",""], 

		["fred@aol.com","","https://www.example.com/gdpr","5/3/2018 11:54 AM",""], 

		["sam@aol.com","","https://www.example.com/gdpr","5/4/2018 5:55 PM",""]]}

Opens
Email address Name Timestamp


		{"downloadGuid":"7a397d2b-9a9f-4ae1-a4d3-cf44cffd5b8f","totalRows":6, 

		"userData":[["aaron@example.com","Aaron Example","5/2/2018 1:45 PM"], 

		["dave@yahoo.com","","5/17/2018 9:08 AM"], 

		["ben@aol.com","","5/2/2018 1:49 PM"], 

		["carol@aol.com","Carol Example","5/3/2018 12:32 AM"], 

		["al@yahoo.com","Al Example","5/2/2018 10:22 PM"], 

		["dave@msn.com","","5/2/2018 1:24 PM"]]}

Deliverability
Email address Name Status Timestamp


		{"downloadGuid":"5bad0a0e-afa0-40ed-9a71-f78dba8a9a11","totalRows":7, 

		"userData":[["joe@example.com","Joe Example","Success", "5/2/2018 1:15 PM"], 

		["sam@aol.com","","Success","5/2/2018 1:15 PM"], 

		["al@aol.com","","Unknown user","5/2/2018 1:15 PM"], 

		["dave@msn.com","","Success","5/2/2018 1:15 PM"], 

		["fred@yahoo.com","","Unknown user","5/2/2018 1:16 PM"], 

		["abe@aol.com","Abe Example","Success","5/2/2018 1:15 PM"], 

		["matt@aol.com","Matt Example","Unknown user","5/2/2018 1:15 PM"]]}

Complaints
Email address Name Timestamp


		{"downloadGuid":"a7323990-2277-4e54-9026-3af3f144fc49","totalRows":2,

		"userData":[["joe@aol.com","Joe Example","9/6/2018 3:56 AM"],

		["Preston@aol.com","Preston Example","7/9/2018 2:10 PM"]]}

EXAMPLE

using System;
using System.Net.Http;

string url = "https://example.com/API/Rest/Mailings/Report?accountName=acme&login=ApiUser&mailingTitle=Test1&reportType=Clicks";

// Reuse HttpClient for multiple requests in production code.
using (var client = new HttpClient())
using (var request = new HttpRequestMessage(HttpMethod.Get, url))
{
	request.Headers.Add("Password", "YOUR_PASSWORD");

	using (HttpResponseMessage response = await client.SendAsync(request))
	{
		response.EnsureSuccessStatusCode();
		Console.WriteLine(await response.Content.ReadAsStringAsync());
	}
}

# encoding: utf-8
require 'rest-client'
require 'json'
							
url = 'https://example.com/API/Rest/Mailings/Report?accountName=acme&login=ApiUser&mailingTitle=Test1&reportType=Clicks'
response = RestClient.get(url, {:Password => "YOUR_PASSWORD"})
puts response

import requests

url = "https://example.com/API/Rest/Mailings/Report?accountName=acme&login=ApiUser&mailingTitle=Test1&reportType=Clicks"
headers = {'password':'YOUR_PASSWORD'}
resp = requests.get(url, headers=headers)
if resp.status_code == 200:
	print(resp.text)

https://example.com/API/Rest/Mailings/Report?accountName=acme&login=ApiUser&password=YOUR_PASSWORD&mailingTitle=Test1&reportType=Clicks