Page History

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 19) gets a list of available delivery report names, including delivery reports for campaigns.
See also What is a sent message?

Note
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':

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

DeliveryReport[] reports = tmClient.getDeliveryReport("mycampaign-020411");

To get the delivery report details for 'mycampaign-020411' between 01:00 and 02:00 on 1st Jan 2011:

Code Block

theme	RDark
language	java
title	Example

Calendar cal_start = Calendar.getInstance();
cal_start.set(2011, 1, 1, 1, 0, 0);
Calendar cal_end = Calendar.getInstance();
cal_end.set(2011, 1, 1, 2, 0, 0);
DeliveryReport[] reports = tmClient.getDeliveryReport("mycampaign-020411", 
cal_start.getTime(), cal_end.getTime);

Or, between 01:00 on 1st Jan 2011 and now:

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

Calendar cal = Calendar.getInstance();
cal.set(2011, 1, 1);
DeliveryReport[] reports = tmClient.getDeliveryReport("mycampaign-020411", 
cal.getTime(), new Date());

To get delivery report details for all campaigns and API sends between the same dates as the previous 2 examples:

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

Calendar cal_start = Calendar.getInstance();
cal_start.set(2011, 1, 1, 1, 0, 0);
Calendar cal_end = Calendar.getInstance();
cal_end.set(2011, 1, 1, 2, 0, 0);
DeliveryReport[] reports = tmClient.getDeliveryReport("all", cal_start.getTime(), 
cal_end.getTime);

reports = tmClient.getDeliveryReport("all", cal.getTime(), new Date());

To get a delivery report with the name 'mycampaign-020411', restricted to those messages sent with custom tag 'test':

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

DeliveryReport[] reports = tmClient.getDeliveryReport("mycampaign-020411", "test");

To get the status of messages from all delivery reports for messages sent with custom tag 'test':

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

DeliveryReport[] reports = tmClient.getDeliveryReport("all", "test");

The same as the previous 2 examples, but between 2 dates:

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

Calendar cal_start = Calendar.getInstance();
cal_start.set(2011, 1, 1, 1, 0, 0);
Calendar cal_end = Calendar.getInstance();
cal_end.set(2011, 1, 1, 2, 0, 0);
DeliveryReport[] reports = tmClient.getDeliveryReport("all", "test", 
cal_start.getTime(), cal_end.getTime);
reports = tmClient.getDeliveryReport("all", "test", cal.getTime(), new Date());

A complete example, including output:

Code Block

theme	RDark
language	java
title	Example
linenumbers	true

DeliveryReport[] reports = tmClient.getDeliveryReport("all");
for(DeliveryReport report: reports) {
	System.out.println(report);
	for(Hashtable<String, String> row: report.getRows()) {
		System.out.println("\tMessage ID: " + row.get("message_id"));
		System.out.println("\tLast Updated: " + row.get("last_updated"));
		System.out.println("\tMobile Number: " + row.get("mobile_number"));
		System.out.println("\tStatus: " + row.get("status"));
		System.out.println("\tCustom Tag: " + row.get("custom"));
	}
}

Returns:

an DeliveryReport object array. Each Hashtable represents a delivery report and has 5 keys, 'name', 'last_updated', 'extension' and 'rows':

Array key	Value
name	String. The name of the delivery report containing the message statuses. For campaigns sent via the web interface, this is the campaign name that way specified. For messages sent via one of our APIs, the name is GatewayAPI_DD-MM-YY, where DD is the calendar day, MM the month, and YY the year.
last_updated	String. The last time a message delivery status in this delivery report was updated, ISO 8601 format. This allows you to determine whether there was a change since you last accessed the report.
extension	DEPRECATED – this value no longer has any meaning.
rows	ArrayList. rows is an ArrayList of Hashtable with keys 'message_id', 'mobile_number', 'status' and 'last_updated' (see below).

reportrow is an array with 4 keys:

Array key	Value
message_id	String. The unique ID of the sent message (different for each number sent to).
mobile_number	String. The mobile number that the message was sent to, in international format, e.g. 447000000000.
status	String. The status of the message delivery. PENDING means the status of the sent message is currently unknown. REJECTED means that the relevant operator rejected the message and did not attempt to deliver it. FAILED probably means that the number doesn't exist (or not anymore), or the recipient didn't turn on their phone to receive the message and it expired. DELIVERED means the message was received on the handset. NON-UK means you are on a UK-only acount and have to send a non-UK number.
last_updated	String. The last time this message delivery status was updated, ISO 8601 format. This allows you to determine whether there has been a change since you last accessed the report.

Specific error codes:

Code	Meaning
0	The custom value must contain only alpha-numeric characters.
1	The custom value must be between 1 and 20 characters in length.
2	The 'from' and 'to' timestamps must be in ISO 8601 format.

Note
error code 404 is reported if no delivery reports are found using the specified search criteria. See General error codes.

Panel
title	Next	: getDeliveryReports

Panel

title	All Functions

Wrapper Functions

Panel

title	Download

Java Wrapper

Home: Developers Documentation

Versions Compared

Old Version 4

New Version Current

Key