Report Server Web service endpoints

The Report Server Web service provides several endpoints for managing a report server and executing and navigating reports.

The management endpoints

There are three endpoints available for managing objects on a report server, ReportService2005, ReportService2006, and ReportService2010. The ReportService2005 endpoint is used for managing objects on a report server that is configured for native mode. The ReportService2006 endpoint is used for managing objects on a report server that is configured for SharePoint integrated mode. The ReportService2010 endpoint merges the functionalities of ReportService2005 and ReportService2006 and can manage objects on a report server that are configured for either native or SharePoint integrated mode.

Important

When a report server is configured for SharePoint integrated mode, the ReportService2005 APIs will return an rsOperationNotSupportedSharePointMode error. If the report server is configured for native mode, the ReportService2006 APIs will return an rsOperationNotSupportedNativeMode error. Similarly, when mode-specific APIs in ReportService2010 are used on unintended modes, the APIs will return the respective errors.

Note

The ReportService2005 and ReportService2006 endpoints are deprecated in SQL Server 2008 R2 (10.50.x). The ReportService2010 endpoint includes the functionalities of both endpoints and contains additional management features.

If the report server is configured for native mode or SharePoint integrate mode, the WSDL for the management endpoint can be accessed by using one of the following URLs:

https://<Server Name>/ReportServer/ReportService2010.asmx?wsdl  

For more information, see Accessing the SOAP API.

The Execution Endpoint

The ReportExecution2005 endpoint makes it easy for developers to customize report processing and rendering from a report server in both native and SharePoint integrated modes. The endpoint includes classes and methods that existed in earlier versions of the Report Server Web service. In addition, many new classes and methods have been added to the Report Server Web service that are exposed through the execution endpoint.

The WSDL for the management endpoint can be accessed using the following URL:

https://<Server Name>/ReportServer/ReportExecution2005.asmx?wsdl  

If the report server is configured for SharePoint integrate mode, the WSDL can be accessed using the following URL:

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx?wsdl  

For more information, please see Accessing the SOAP API.

SharePoint proxy endpoints

When a report server is configured for SharePoint integrated mode and the Reporting Services Add-in has been installed, a set of proxy endpoints are installed on the SharePoint server. The proxy endpoints are the primary API for developing report solutions when a report server is configured for SharePoint integrated mode. When you develop against the proxy endpoints, the Reporting Services, Add-in manages the exchange of credentials between the SharePoint server and the report server in Trusted account authentication mode. When you develop against the report server endpoints, the calling application must manage the credential exchange in Trusted account authentication mode. The following table lists the endpoints that are installed with the Reporting Services Add-in.

Proxy Endpoint Description
ReportService2006 Provides the APIs for managing a report server that is configured for SharePoint integrate mode.

Note: This endpoint is deprecated in SQL Server 2008 R2 (10.50.x).
ReportService2010 Provides the APIs for managing a report server that is configured for either native or SharePoint integrated mode.
ReportExecution2005 Provides the APIs for running and navigating reports.
ReportServiceAuthentication Provides the APIs for authenticating users against a report server when the SharePoint Web application is configured for Forms Authentication.

The following are example URLs for referencing the proxy endpoints on a SharePoint site.

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportService2010.asmx  
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx  
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportServiceAuthentication.asmx  

Building Applications Using the Web Service and the .NET Framework