Contact_Get_History( string keystring emailoptional struct optionalParameters)

Note: When using one of the API wrappers, you do not need to pass the API key. The wrapper will pass the key for you, your first parameter should be the second parameter in the signature.


Get the history for a contact. All contact history data is returned by default


  string key Your API key - used to authenticate your account
  string email An email address
optional struct optionalParameters A struct of optional parameters, see below for valid keys
Format for minDate and maxDate:
- A specified date/time in the format: YYYY-MM-DD HH:MM:SS
- A relative time string including, but not limited to:
* "now"
* "today"
* "tomorrow"
* "first day of January 2010" (example)
* "last day of March 2010" (example)
* "Monday this week" (example)
* "Tuesday next week" (example)

- Values allowed in the historyTypes:
* click
* open
* send
* status
* customFields
* subscription
* bounce

optionalParameters can include:

string minDate Return contact history created on or after minDate. Format as UTC.
string maxDate Return contact history created on or before maxDate. Format as UTC.
struct historyTypes Limit the type of contact history data returned.
struct campaignIds A struct of campaign IDs


struct Returns a struct of history information

Still need help? Contact Us Contact Us