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


XML Request Example (call by list name):      

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

   

XML Request Example (call by list ID):     

  

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

  

<xmlrequest> element


Field Name Description
username Username used to login to Pinpointe
usertoken Unique token assigned to Pinpointe account
requesttype Name of API set to be used
requestmethod Function being called
details Use <name>List Name</name> or <listid>INTEGER</listid>. Replace italicized characters with actual values.


Successful Response Example:

  

<response>
   <status>SUCCESS</status>
   <data>
      <item>
         <listid>70</listid>
         <name>2-testlist</name>
         <createdate>1323749308</createdate>
         <subscribecount>41577</subscribecount>
         <unsubscribecount>749</unsubscribecount>
      </item>
   </data>
</response>

  


Successful Response:


<response> element


Field Name Description
status Will return SUCCESS if user was successfully added
data Contact ID number


<response>

<data>

<item> element


Field Name Description
listid ID number for list
name Descriptive name for list
createdate Returns UNIX time formatted date (number of seconds since January 1, 1970)
subscribecount Number of contacts subscribed to list
unsubscribecount Number of unsubscribed contacts for list
autorespondercount  Number of autoresponders associated with list


Unsuccessful Response:


<response> element


Field Name Description
status Will return ERROR when unsuccessful
errormessage

Text explaining why request failed