Mailchimp API

Get all the information for a particular member of a list

Section:

List Related

Parameters:

apikey

a valid API Key for your user account. Get by calling Get by visiting your API dashboard

id	the list id to connect to. Get by calling lists()

email_address

the member email address to get information for

Returns:

array   -  array of list member info (see Returned Fields for details)

Returned Fields:

string

email

The email address associated with this record

string

email_type

The type of emails this customer asked to get: html or text

array

merges

An associative array of all the merge tags and the data for those tags for this email address. Note: Interest Groups are returned as comma delimited strings - if a group name contains a comma, it will be escaped with a backslash. ie, "," => "\,"

string

status

The subscription status for this email address, either subscribed, unsubscribed or cleaned

string

ip_opt

IP Address this address opted in from.

string

ip_signup

IP Address this address signed up from.

date

timestamp

The time this email address was added to the list

Examples (2)

download example code

[1] mcapi_listMemberInfo.php

<?php
/**
This Example shows how to pull the Info for a Member 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->listMemberInfo( $listId, $my_email );
 
if ($api->errorCode){
	echo "Unable to load listMemberInfo()!\n";
	echo "\tCode=".$api->errorCode."\n";
	echo "\tMsg=".$api->errorMessage."\n";
} else {
    echo "Member info:\n";
    //below is stupid code specific to what is returned
    //Don't actually do something like this.
    foreach($retval as $k=>$v){
        if (is_array($v)){
            //handle the merges
            foreach($v as $l=>$w){
                echo "\t$l = $w\n";
            }
        } else {
            echo "$k = $v\n";
        }
    }
}
 

[2] xml-rpc_listMemberInfo.php

<?php
/**
This Example shows how to retrieve a list subscriber's information using XML-RPC
Note that we are using the PEAR XML-RPC client and recommend others do as well.
**/
require_once 'XML/RPC2/Client.php';
require_once 'inc/config.inc.php';
try {
    $client = XML_RPC2_Client::create($apiUrl);
 
	$result = $client->listMemberInfo($apikey, $listId, $my_email);
	echo "SUCCESS! \n";
	echo "Info for: ".$result['email']."\n";
	echo " Email Type: ".$result['email_type']."\n";
	echo " Status: ".$result['status']."\n";
	echo " Timestamp: ".$result['timestamp']."\n";
	echo " Merges:\n";
	foreach($result['merges'] as $k=>$v){
	    echo "\t$k = $v\n";
	}
} catch (XML_RPC2_FaultException $e){
	echo "ERROR!!!!\n";
	echo 'code: '.$e->getFaultCode()."\n";
	echo 'msg : '.$e->getFaultString()."\n";
}