listMembers – v1.2

 listMembers(string apikey, string id, string status, string since, integer start, integer limit)

Get all of the list members for a list that are of a particular status. Are you trying to get a dump including lots of merge data or specific members of a list? If so, checkout the Export API

Section
List Related

mcapi_listMembers.php

Parameters
apikey	a valid API Key for your user account. Get by visiting your API dashboard
id	the list id to connect to. Get by calling lists()
status	the status to get members for - one of(subscribed, unsubscribed, cleaned, updated), defaults to subscribed
since	optional - pull all members whose status (subscribed/unsubscribed/cleaned) has changed or whose profile (updated) has changed since this date/time (in GMT) - format is YYYY-MM-DD HH:mm:ss (24hr)
start	optional - for large data sets, the page number to start at - defaults to 1st page of data (page 0)
limit	optional - for large data sets, the number of results to return - defaults to 100, upper limit set at 15000

Returns
array	Array of list member structs (see Returned Fields for details)

Returned Fields
string	email	Member email address
date	timestamp	timestamp of their associated status date (subscribed, unsubscribed, cleaned, or updated) in GMT

Examples (1)

download example code

[1] mcapi_listMembers.php

<?php
/**
This Example shows how to pull the Members of a List using the MCAPI.php 
class and do some basic error checking.
**/
require_once 'inc/MCAPI.class.php';
require_once 'inc/config.inc.php'; //contains apikey
 
$api = new MCAPI($apikey);
 
$retval = $api->listMembers($listId, 'subscribed', null, 0, 5000 );
 
if ($api->errorCode){
	echo "Unable to load listMembers()!";
	echo "\n\tCode=".$api->errorCode;
	echo "\n\tMsg=".$api->errorMessage."\n";
	echo "Members returned: ". sizeof($retval). "\n";
} else {
	echo "Members returned: ". sizeof($retval). "\n";
	foreach($retval as $member){
	    echo $member['email']." - ".$member['timestamp']."\n";
	}
}
 
?>