API reference
Help CenterCommunityDevelopersAcademyStatus

Get a contact's mailing details - GetContactMailingDetails

Returns details about an Acoustic Campaign mailing sent to a specific contact.

📘

Use with SureFrom code

This call uses the SureFrom code that can be placed in the mailing body.

Elements (Required)

SURE_FROM_CODE - An ID that can return in a mailing body and validate that a mailing is legitimate.

ORGANIZATION_ID - One or more Organization IDs that are checked for the SureFrom code. 

<Envelope>
  <Body>
    <GetContactMailingDetails>
      <SURE_FROM_CODE>1-8QhP4YIS-XYPxqdpK-ia6t4PP3-
+/dKSxVg-uCXkKZka-X77SLMfa-0J+R5TBj-AX3N0CTU
 </SURE_FROM_CODE>
      <ORGANIZATION_ID>1dcd49d-108b594203d-f528764d624db129b32c21fbca0cb8d6</ORGANIZATION_ID>
 </GetContactMailingDetails>
 </Body>
</Envelope>

<Envelope>
  <Body>
    <GetContactMailingDetails>
      <SURE_FROM_CODE>1-8QhP4YIS-XYPxqdpK-ia6t4PP3-
+/dKSxVg-uCXkKZka-X77SLMfa-0J+R5TBj-AX3N0CTU
 </SURE_FROM_CODE>
      <ORGANIZATION_ID>1dcd49d-108b594203d-
f528764d624db129b32c21fbca0cb8d6</ORGANIZATION_ID>
      <ORGANIZATION_ID>2edd49d-108b594203d-
f528764d624db129b32c21fbca0cc9e7</ORGANIZATION_ID>
    </GetContactMailingDetails>
  </Body>
</Envelope>

<Envelope>
  <Body>
    <RESULT>
      <SUCCESS>true</SUCCESS>
      <SENT_TIMESTAMP>09/30/2010 21:08:59 GMT</SENT_TIMESTAMP>
      <FROM_NAME>IBM Support</FROM_NAME>
      <FROM_ADDRESS></FROM_ADDRESS>
      <SUBJECT>Upcoming Release</SUBJECT>
    </RESULT>
  </Body>
</Envelope>

<Envelope>
  <Body>
    <RESULT>
      <SUCCESS>true</SUCCESS>
      <SENT_TIMESTAMP>09/30/2010 21:08:59 GMT</SENT_TIMESTAMP>
      <FROM_NAME>IBM Support</FROM_NAME>
      <FROM_ADDRESS></FROM_ADDRESS>
      <SUBJECT>Upcoming Release</SUBJECT>
    </RESULT>
  </Body>
</Envelope>

<Envelope>
  <Body>
    <RESULT>
      <SUCCESS>false</SUCCESS>
    </RESULT>
    <Fault>
      <Request/>
      <FaultCode/>
      <FaultString>The value you entered could not be confirmed.</FaultString>
      <detail>
        <error>
          <errorid>330</errorid>
          <module/>
          <class>SP.API</class>
          <method/>
        </error>
      </detail>
    </Fault>
  </Body>
</Envelope>

Elements (Results)

SUCCESS - True if successful; False if not.

SENT_TIMESTAMP - The date/time that the mailing was sent in GMT.

FROM_NAME - The From name of the mailing’s sender.

FROM_ADDRESS - The From address (email) of the mailing’s sender.

SUBJECT - The subject of the mailing.

The following response elements only return if the ORGANIZATION_ID is provided in the request:

TO_ADDRESS - The recipient email address of the provided SEND_FROM_CODE.

CLICK_TO_VIEW - The Click To View URL of the personalized mailing body for the provided SEND_FROM_CODE recipient.

ORGANIZATION_ID - The Organization ID of the organization that sent the mailing for the provided SEND_FROM_CODE.