The 'UserID' and 'Password' elements identify the account.
The 'ServiceName' element must be set to 'ReportOverview'.
The 'SoftwareVersion' element is for internal 2SMS use only and should not be set.
The 'ServiceDetail' element should contain a set of children starting with a 'DateRange' element.
This should contain one of the following to determine the time period for the report:
- With 'StartDate' and 'EndDate' children it returns a report for an explicitly specified time-period (up to 31 days).
The DateTime information must be supplied in one of these ISO-8601 formats:
- yyyy-MM-dd'T'HH:mm:ss.SSS in the time-zone registered with the account.
- yyyy-MM-dd'T'HH:mm:ss.SSS'Z' in coordinated universal time (the 'useUTC' attribute must be set to true).
- With a 'RelativeName' child it runs a report for a relative time period described by one of the enumerated values:
'Today'; 'Yesterday'; 'This Month'; or 'Last Month'.
This is evaluated with respect to the time-zone registered with the account.
- With a 'RecentDays' child it runs a report for the specified period of days (up to 14)
in the time-zone registered with the account.
E.g. a value of two would cover the time period from the start of the previous day until the current time.
The 'RelativeName' and 'RecentDays' elements may be followed by a 'SavedReport' element
(not available with 'SubAccount' element).
This stores the report generating information for use with code 0360 requests.
The 'SavedReport' element must contain the following children:
- A 'Name' element containing the name to identify the report in future.
- A 'Format' element containing any additional information useful to the client application (e.g. format for results).
The following additional XML nodes may also be supplied:
- An optional 'useUTC' attribute set to true if date input and output is to be in coordinated universal time.
- An optional 'Status' element to filter results with a specific delivery status (e.g. Success, WithNetwork or Failed).
- An optional 'Destination' element to filter results sent to a specific destination (not available with 'SubAccount' element).
- An optional 'GUID' element to filter results with a specific GUID reference value (not available with 'SubAccount' element).
- An optional 'SubAccount' element containing the UserID of one of the user's sub-accounts.
The overview provided will then cover the specified sub-account rather than the user's own.
For data protection reasons this option is not available with the 'Destination' and 'GUID' elements.
It is also not currently possible to save a report with the 'SubAccount' element.
- A 'GroupBy' element to determine the response output.