REST Email Marketing API Documentation

Subscriptions — List

Provide all the subscribed recipients for a topic.

HTTP VERB

Get

URL

/API/Rest/Subscriptions/List/Topic

ARGUMENTS

topic

Required permission

CreateEditMember

ERRORS

No Permission
Recipient is not in the database
Too many API calls
Database error
Unknown error

RETURNS

Email addresses, in the large data return format:


{"downloadGuid":"0cdd5c1c-a4b2-454b-8f01-279f2a878b98","totalRows":5,"userData":[["joe@example.com"],["deanna@example.com"],["bob@example.com"],["fjfdhfh@example.com"],["fred.smith@example.com"]]}

EXAMPLE

Get the subscription details for one email address.

 
string url = "http://example.com/api/rest/Subscriptions/List/?accountName=acme&login=ApiUser&topic=daily";
							
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/Subscriptions/List?accountName=acme &login=ApiUser &topic=daily'
response = RestClient.get(url, "", {:Password => "sfhdf6df5fdy"})
puts response
						
import requests
url = "http://www.example.com/api/rest/Subscriptions/List?accountName=acme&login=ApiUser&topic=daily";
headers = {'password':'sfhdf6df5fdy'}
resp = requests.get(url, headers=headers)
if resp.status_code == 200:
	print resp.text

http://example.com/api/rest/Subscriptions/List?accountName=acme &login=ApiUser &password=324t35g345g &topic=daily

Share this: