Search for subscribers in a mailing list and retrieve their email addresses.


XML Request Example:     

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>admin</username>
   <usertoken>abc123abc123abc123abc123abc123abc123abc123abc123</usertoken>
   <requesttype>subscribers</requesttype>
   <requestmethod>GetSubscribers</requestmethod>
   <details>
      <searchinfo>
         <List>1</List>
         <Email>@yourdomain.com</Email>
      </searchinfo>
   </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


<details> 

<searchinfo> element


Field NameDescription
ListID of contact list to be searched
EmailEmail address of contact(s) to be located


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if user was successfully added
dataIncludes sub-element count, the number of subscribers; and subscriberlist, a list of email addresses



Unsuccessful Response:


<response> element


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