« Back to Documentation Overview

get_contact_opens

Section: Contacts
Version: 1.5.0


List dates when the messages were opened by contact.
Note that if a contact opened the same message multiple times, only the newest date is listed.
Hint: If you want to keep opens synchronized with external database, then setting open callback is much more efficient than querying this method periodically.


Parameters
stringAPI_KEY
object
stringcontactCONTACT_ID
Return Value
stringMESSAGE_ID2010-01-02 00:00:00

Example Request JSON

[
    "API_KEY",
    {
        "contact": "CONTACT_ID"
    }
]

Example Response JSON

{
    "MESSAGE_ID": "2010-01-02 00:00:00"
}

Example Error Response JSON

{
    "code": -1,
    "message": "Missing contact"
}
Method-specific Errors
Missing contact
API-wide Errors
API key verification failed API key verification failed
API client IP not allowed API client IP not allowed
Invalid params Attribute params must be reference to hash