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:      

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>JohnDoe</username>
   <usertoken>abc123abc123abc123abc123</usertoken>
   <requesttype>Lists</requesttype>
   <requestmethod>findlist</requestmethod>
   <details>
      <!-- either list name OR list ID must be provided -->
      <list>123456</list>
      <name>list1</name>
   </details>
</xmlrequest>


<xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeLists
requestmethodfindlist


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, if <list> tag is used, <name></name> should be deleted. 


<details> element


Field NameDescription
list
(Required if <name> tag not used)
Find the database mailing list with this ID number. 
name
(Required if <list> tag not used)
Find the database mailing list with this name. 



Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if list was successfully found
dataContact ID number


Unsuccessful Response:


<response> element


Field NameDescription
statusWill return ERROR when unsuccessful
errormessage

Text explaining why request failed