Retrieve contacts within or or more tags with option to exclude contacts belonging to a subset of to-be-excluded tags (Called "lists" within the GUI application).


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>DRB-Test</username>
  <usertoken>a1de7f1e68e24201ad22a0cb166eee90c969237e</usertoken>
  <requesttype>Tags</requesttype>
  <requestmethod>GetTagSubscribers</requestmethod>
  <details>
    <tag>{*include_tag_id*}</tag> <!-- required -->
    <tag>{*include_tag_id*}</tag>
    <extag>{*exclude_tag_id*}</extag>
    <extag>{*exclude_tag_id*}</extag>
    <status>{*status: any|active|inactive|bounced|unsubscribed*}</status>
  </details>
</xmlrequest>


XML

 <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


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, If no tag is to be excluded, remove the <extag>{*exclude_tag_id*}</extag> elements. In addition, if only one tag is being searched, remove all unused <tag></tag> elements.


<details> element

<tag>


Field NameDescription
tag
(Required)
ID of tag to be searched. At least one required.  
extag
ID of optional tag who contacts should be excluded from the search.
status
Select from the options provided to search for contacts with that status.


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if contacts were successfully found.
dataContact count, status selected, subscriber details.


Unsuccessful Response:


<response> element


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