Returns ID numbers and statistics for all mailing lists. Statistics include number of subscribers, number of contacts who have unsubscribed, and the number of autoresponders associated with each list.


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>admin</username>
   <usertoken>abc123abc123abc123abc123abc123abc123abc123abc123</usertoken>
   <requesttype>lists</requesttype>
   <requestmethod>GetLists</requestmethod>
   <details>
   </details>
</xmlrequest>

 <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeName of API set to be used
requestmethodFunction being called
detailsThis empty element is required


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if user was successfully added
dataContact ID number


<response>

<data>

<item> element - One will be returned for each contact list


Field NameDescription
listidID number for list
nameDescriptive name for list
subscribecountNumber of contacts subscribed to list
unsubscribecountNumber of unsubscribed contacts for list
autorespondercount Number of autoresponders associated with list


Unsuccessful Response:


<response> element


Field NameDescription
statusWill return ERROR when unsuccessful
errormessageText explaining why request failed