Retrieve a Triggered Send Summary

This page contains information about retrieving a summary of information associated with a triggered send via the SOAP API.

Why Retrieve a Triggered Send Summary

The triggered send summary provides more tracking information regarding a triggered send, allowing you to better understand the effectiveness of the email message being sent and make decisions based on the information.

How to Retrieve a Triggered Send Summary

Use the sample code below as a model to construct your own API code. To view information about a specific triggered send event, perform this retrieve and filter the results on the TriggeredSendDefinitionObjectID property.

Sample .NET Code

public APIObject[] TSSummary()
{
            RetrieveRequest rr = new RetrieveRequest();
            rr.ObjectType = "TriggeredSendSummary";
            rr.Properties = new String[] { "Sent", "Bounces", "Opens", "Clicks" };
            TriggeredSendSummary tss = new TriggeredSendSummary();
            SimpleFilterPart sfp = new SimpleFilterPart();
            sfp.SimpleOperator = SimpleOperators.equals;
            sfp.Property = "CustomerKey";
            sfp.Value = new string[] { "Weekly_Newsletter_-_2009_07_16" };
            rr.Filter = sfp;
            string requestID;

            APIObject[] results;
            string status = client.Retrieve(rr, out requestID, out results);
            return results;
}

Sample SOAP Envelope

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-24440876" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>XXXXX</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">XXXXX</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <RetrieveRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
         <RetrieveRequest>
            <ObjectType>TriggeredSendSummary</ObjectType>
            <Properties>Sent</Properties>
            <Properties>CustomerKey</Properties>
            <Properties>NotSentDueToOptOut</Properties>
            <Properties>NotSentDueToUndeliverable</Properties>
            <Properties>Bounces</Properties>
            <Properties>Opens</Properties>
            <Properties>Clicks</Properties>
            <Properties>UniqueOpens</Properties>
            <Properties>UniqueClicks</Properties>
            <Properties>OptOuts</Properties>
            <Properties>SurveyResponses</Properties>
            <Properties>Conversions</Properties>
            <Properties>UniqueConversions</Properties>
            <Properties>InProcess</Properties>
            <Properties>NotSentDueToError</Properties>
            <Filter xsi:type="ns1:SimpleFilterPart" xmlns:ns1="http://exacttarget.com/wsdl/partnerAPI">
               <Property>CustomerKey</Property>
               <SimpleOperator>equals</SimpleOperator>
               <Value>TESTING</Value>
            </Filter>
         </RetrieveRequest>
      </RetrieveRequestMsg>
   </soapenv:Body>
</soapenv:Envelope>