Search for subscribers in a mailing list and retrieve their respective information including subscriber ID, email address, whether confirmed or not and other relevant information.


XML Request Example:     

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>DRB-Test</username>
  <usertoken>a1de7f1e68e24201ad22a0cb166eee90c969237e</usertoken>
  <requesttype>Lists</requesttype>
  <requestmethod>GetListSubscribers</requestmethod>
  <details>
    <list>{*list_id*}</list> <!-- required -->
    <list>{*list_id*}</list>
    <status>{*status: any|active|inactive|bounced|unsubscribed*}</status>
    <include_membership>{*include_membership_boolean*}</include_membership>
  </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> 


Field NameDescription
ListID of list to be searched.
Can add multiple <list> tags to search more than one list.
statusStatus of contacts to be searched for. Value can be any, active, inactive, bounced or unsubscribed. Default is any.


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if user was successfully added
dataIncludes relevant data per contact


Example of returned data:


Unsuccessful Response:


<response> element


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