GetOptInStatusList

Overview

Returns the Opt In Status of all email addresses in an account via an http form post. R

Notes

Email Opt In Status is stored in the account, and not tied directly to a contact.   Deleting a contact or changing a contact’s email address will not change the opt in status for the email address.

If an email address is not listed in this API function, then it’s status is “Unknown”

WARNING:  This command can return a large amount of data.   Please plan accordingly.

Post Url

https://hyperdrivepro.morethanrewards.com/api/2/GetOptInStatusList.aspx

- SSL is required

Form Fields

FieldMax Length*RequiredNotes
response_type
YesSet this field value to json to return results in JSON format
accountid
YesMust be numeric. Account ID for this account.
apikey
YesAPI Key for this account.

 

Sample Results

Success Messages

<?xml version="1.0"?> 
<results>
   <emails>
     <email>
         <address>test@domain.com</address>
         <status>Opt In</status>
     </email>
     <email>
         <address>test2@domain.com</address>
         <status>Bounced</status>
     </email>
   </emails> 
</results>


Possible Values for OptInStatus:

Opt In
Opt Out
Unknown
Pending
Bounced
Spam Report

Sample Failure Messages

<?xml version="1.0"?> 
<results>
     <error>Authentication failed</error> 
</results>