Returns ID numbers and statistics for all mailing lists. Statistics include number of subscribers, number of contacts who have unsubscribed, and number of contacts who have bounced.


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>JohnDoe</username>
   <usertoken>abc123abc123abc123abc123</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
requesttypeLists
requestmethodGetLists
detailsThis empty element is required but no input required from user


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if lists found for the user name supplied


<response>

<data>

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


Field NameDescription
owneridAccount owner ID
ownernameAccount owner contact name
owneremailAccount owner email address
listidID number for list
nameDescriptive name for list
descriptionList description if present
subscribecountNumber of contacts subscribed to list
unsubscribecountNumber of unsubscribed contacts for list
bouncecountNumber of bounced contacts for list
usernameUsername for account
fullnameUsername for account
sendfromsend-from email address for each respective list presented
totalcountTotal count for all subscribers in list regardless of status


Unsuccessful Response:


<response> element


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