Retrieve an individual delivery report (or combined reports), which shows the current known status of messages sent in a given time period, or for a particular campaign or campaigns.
Conversely, the function getDeliveryReports (page 18) gets a list of available delivery report names, including delivery reports for campaigns.
See also What is a sent message?
E messages sent with the API can be given a 'tag'. The getDeliveryReport function allows you to specify that tag in order to restrict your search.
To get the contents of a delivery report for the campaign name 'mycampaign-020411':
To get the delivery report details for 'mycampaign-020411' between 01:00 and 02:00 on 1st Jan 2011:
Or, between 01:00 on 1st Jan 2011 and now:
To get delivery report details for all campaigns and API sends between the same dates as the previous 2 examples:
To get a delivery report with the name 'mycampaign-020411', restricted to those messages sent with custom tag 'test':
To get the status of messages from all delivery reports for messages sent with custom tag 'test':
The same as the previous 2 examples, but between 2 dates:
A complete example, including output: