Office 365 Reporting web service reporting.svc document

This topic describes the Office 365 Reporting web servicereporting.svc document, which informs the application of the available reports based on the user account privileges.

Applies to: Office 365

Reporting.svc document structure

To retrieve the Reporting web service description document, use the following URL. The path is not case-sensitive.

https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/

The following is an example service description document returned by the Reporting web service.

<?xml version="1.0" encoding="utf-8"?>
<service 
  xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
  xmlns="http://www.w3.org/2007/app" 
  xmlns:atom="http://www.w3.org/2005/Atom">
<workspace>
<atom:title>Default</atom:title>
<collection href="MailboxActivityDaily">
<atom:title>MailboxActivityDaily</atom:title>
</collection>
<collection href="MailboxActivityWeekly">
<atom:title>MailboxActivityWeekly</atom:title>
</collection>
<collection href="MailboxActivityMonthly">
<atom:title>MailboxActivityMonthly</atom:title>
</collection>
<collection href="MailboxActivityYearly">
<atom:title>MailboxActivityYearly</atom:title>
</collection>
<collection href="GroupActivityDaily">
<atom:title>GroupActivityDaily</atom:title>
</collection>
<collection href="GroupActivityWeekly">
<atom:title>GroupActivityWeekly</atom:title>
</collection>
<collection href="GroupActivityMonthly">
<atom:title>GroupActivityMonthly</atom:title>
</collection>
<collection href="GroupActivityYearly">
<atom:title>GroupActivityYearly</atom:title>
</collection>
<collection href="StaleMailbox">
<atom:title>StaleMailbox</atom:title>
</collection>
<collection href="StaleMailboxDetail">
<atom:title>StaleMailboxDetail</atom:title>
</collection>
<collection href="MailboxUsage">
<atom:title>MailboxUsage</atom:title>
</collection>
<collection href="MailboxUsageDetail">
<atom:title>MailboxUsageDetail</atom:title>
</collection>
<collection href="CsActiveUserDaily">
<atom:title>CsActiveUserDaily</atom:title>
</collection>
<collection href="CsActiveUserWeekly">
<atom:title>CsActiveUserWeekly</atom:title>
</collection>
<collection href="CsActiveUserMonthly">
<atom:title>CsActiveUserMonthly</atom:title>
</collection>
<collection href="CsActiveUserYearly">
<atom:title>CsActiveUserYearly</atom:title>
</collection>
<collection href="CsConferenceDaily">
<atom:title>CsConferenceDaily</atom:title>
</collection>
<collection href="CsConferenceWeekly">
<atom:title>CsConferenceWeekly</atom:title>
</collection>
<collection href="CsConferenceMonthly">
<atom:title>CsConferenceMonthly</atom:title>
</collection>
<collection href="CsP2PSessionDaily">
<atom:title>CsP2PSessionDaily</atom:title>
</collection>
<collection href="CsP2PSessionWeekly">
<atom:title>CsP2PSessionWeekly</atom:title>
</collection>
<collection href="CsP2PSessionMonthly">
<atom:title>CsP2PSessionMonthly</atom:title>
</collection>
<collection href="CsP2PAVTimeDaily">
<atom:title>CsP2PAVTimeDaily</atom:title>
</collection>
<collection href="CsP2PAVTimeWeekly">
<atom:title>CsP2PAVTimeWeekly</atom:title>
</collection>
<collection href="CsP2PAVTimeMonthly">
<atom:title>CsP2PAVTimeMonthly</atom:title>
</collection>
<collection href="CsAVConferenceTimeDaily">
<atom:title>CsAVConferenceTimeDaily</atom:title>
</collection>
<collection href="CsAVConferenceTimeWeekly">
<atom:title>CsAVConferenceTimeWeekly</atom:title>
</collection>
<collection href="CsAVConferenceTimeMonthly">
<atom:title>CsAVConferenceTimeMonthly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeDaily">
<atom:title>ConnectionbyClientTypeDaily</atom:title>
</collection>
<collection href="ConnectionbyClientTypeWeekly">
<atom:title>ConnectionbyClientTypeWeekly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeMonthly">
<atom:title>ConnectionbyClientTypeMonthly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeYearly">
<atom:title>ConnectionbyClientTypeYearly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeDetailDaily">
<atom:title>ConnectionbyClientTypeDetailDaily</atom:title>
</collection>
<collection href="ConnectionbyClientTypeDetailWeekly">
<atom:title>ConnectionbyClientTypeDetailWeekly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeDetailMonthly">
<atom:title>ConnectionbyClientTypeDetailMonthly</atom:title>
</collection>
<collection href="ConnectionbyClientTypeDetailYearly">
<atom:title>ConnectionbyClientTypeDetailYearly</atom:title>
</collection>
<collection href="MailTraffic">
<atom:title>MailTraffic</atom:title>
</collection>
<collection href="MailTrafficTop">
<atom:title>MailTrafficTop</atom:title>
</collection>
<collection href="MailTrafficPolicy">
<atom:title>MailTrafficPolicy</atom:title>
</collection>
<collection href="MailFilterList">
<atom:title>MailFilterList</atom:title>
</collection>
<collection href="MailTrafficSummary">
<atom:title>MailTrafficSummary</atom:title>
</collection>
<collection href="MailDetailSpam">
<atom:title>MailDetailSpam</atom:title>
</collection>
<collection href="MailDetailMalware">
<atom:title>MailDetailMalware</atom:title>
</collection>
<collection href="MailDetailDlpPolicy">
<atom:title>MailDetailDlpPolicy</atom:title>
</collection>
<collection href="MailDetailTransportRule">
<atom:title>MailDetailTransportRule</atom:title>
</collection>
<collection href="MessageTrace">
<atom:title>MessageTrace</atom:title>
</collection>
<collection href="MessageTraceDetail">
<atom:title>MessageTraceDetail</atom:title>
</collection>
<collection href="MxRecordReport">
<atom:title>MxRecordReport</atom:title>
</collection>
<collection href="OutboundConnectorReport">
<atom:title>OutboundConnectorReport</atom:title>
</collection>
<collection href="ServiceDeliveryReport">
<atom:title>ServiceDeliveryReport</atom:title>
</collection>
</workspace>
</service>

Each <collection><title>…</title></collection> item represents an available report that the user can access. The href attribute on the collection element represents the report name your application should use in the URLs it constructs. Your application should use the atom:title element value as the display name for the report.

You can also retrieve a more detailed list of report definition information in the $metadata document, at the following URL.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/$metadata

For more information, see Common metadata returned by the Office 365 Reporting web service.

Important

Which reports are available to a user depends on the administrator privileges they've been granted in the organization. Because the list of reports available to each user depends on their permissions, be careful that your application adjusts accordingly.

For example, if you have a lower-level administrator account, don't assume that the reports you can access are all the reports available. All reports are available to the Global Administrator. However, be aware that at any time, some reports might be unavailable based on the organization's Office 365 subscription. If you're building a comprehensive reporting tool, do not rely on your own account's permissions to generate the reference list of reports available in Office 365.

See also

Concepts

Common metadata returned by the Office 365 Reporting web service