This is an older version of the Campaign Monitor API. We strongly encourage you to quit livin' in the past and use the shiny new RESTful version with lots of new functionality. You won't regret it.

API › Campaign.GetSummary

Campaign.GetSummary

Gets a statistical summary, including number of recipients and open count, for a given campaign.

Parameters and required information

Here’s a list of all the parameters you’ll need to pass to the Campaign.GetSummary method. All of the parameters are required unless otherwise noted.

ApiKey
Your API application key. See here for more details.

CampaignID
The ID of the campaign you want data for. You can get the ID via the Client.GetCampaigns method.

Return Codes

Success

Upon a successful call, this method will return summary statistical values about this particular campaign including the number of recipients, the number of total opens, the number of unique opens, the number of link clicks, the number of recipients who unsubscribed and the number who bounced.

Error

100: Invalid API Key
The API key pass was not valid or has expired.

301: Invalid CampaignID
The CampaignID value passed in was not valid.

SOAP 1.1

The following is a sample SOAP request and response. The placeholders shown need to be replaced with actual values.

POST /api/api.asmx HTTP/1.1
Host: api.createsend.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.createsend.com/api/Campaign.GetSummary"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Campaign.GetSummary xmlns="http://api.createsend.com/api/">
      <ApiKey>string</ApiKey>
      <CampaignID>string</CampaignID>
    </Campaign.GetSummary>
  </soap:Body>
</soap:Envelope>
 
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Campaign.GetSummaryResponse xmlns="http://api.createsend.com/api/">
      <Campaign.GetSummaryResult>
        <Recipients>int</Recipients>
        <TotalOpened>int</TotalOpened>
        <UniqueOpened>int</UniqueOpened>
        <Clicks>int</Clicks>
        <Unsubscribed>int</Unsubscribed>
        <Bounced>int</Bounced>
      </Campaign.GetSummaryResult>
    </Campaign.GetSummaryResponse>
  </soap:Body>

</soap:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /api/api.asmx/Campaign.GetSummary?ApiKey=string&CampaignID=string HTTP/1.1
Host: api.createsend.com
 
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<CampaignSummary xmlns="http://api.createsend.com/api/">
  <Recipients>int</Recipients>
  <TotalOpened>int</TotalOpened>
  <UniqueOpened>int</UniqueOpened>
  <Clicks>int</Clicks>
  <Unsubscribed>int</Unsubscribed>
  <Bounced>int</Bounced>
</CampaignSummary>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /api/api.asmx/Campaign.GetSummary HTTP/1.1
Host: api.createsend.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

ApiKey=string&CampaignID=string
 
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<CampaignSummary xmlns="http://api.createsend.com/api/">
  <Recipients>int</Recipients>
  <TotalOpened>int</TotalOpened>
  <UniqueOpened>int</UniqueOpened>
  <Clicks>int</Clicks>
  <Unsubscribed>int</Unsubscribed>
  <Bounced>int</Bounced>
</CampaignSummary>