PLEASE NOTE: THIS CALL FUNCTIONALITY WAS PREVIOUSLY PROVIDED VIA IsSubscriberlOnList, WHICH HAS BEEN DEPRECATED. USERS SHOULD USE IsEmailOnList.


Determine whether a contact is in a mailing list by checking their email address.


XML Request Example:     

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>admin</username>
   <usertoken>abc123abc123abc123abc123abc123abc123abc123abc123</usertoken>
   <requesttype>Subscribers</requesttype>
   <requestmethod>IsEmailOnList</requestmethod>
   <details>
      <email>john.doe@yourdomain.com</email>  <!-- required -->
      <list>1</list>  <!-- required -->
   </details>
</xmlrequest>

 <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeSubscribers
requestmethodIsEmailOnList


<details> element


Field NameDescription
email (Required)Email address of contact to be located
list (Required)ID of list to search for contact


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if user was successfully found
dataWill return subscriber ID if found


Unsuccessful Response:


<response> element


Field NameDescription
statusWill return Failed if unsuccessful
error messageText explaining why request failed