Discover the URL for Your Organization with IDiscoveryService Web Service

[Applies to: Microsoft Dynamics CRM 2011]

The IDiscoveryService Web service is used to determine the organizations that a user is a member of, and the endpoint address URL to access the IOrganizationService Web service for each of those organizations. This discovery service is necessary because Microsoft Dynamics CRM 2011 is a multi-tenant environment—a single Microsoft Dynamics CRM server can host multiple business organizations. By using the discovery Web service, your application can determine the endpoint address URL to access the target organization’s business data.

For Microsoft Dynamics CRM 2011 installations, server and organization allocation may change as part of datacenter management and load balancing. Therefore, the IDiscoveryService Web service provides a way to discover which Microsoft Dynamics CRM server is serving your organization at a given time.

The following table lists the Web service URLs for the worldwide Microsoft Dynamics CRM Online data centers.


Location Discovery Web service URL Identity Provider

North America

Microsoft account

Microsoft Office 365


Microsoft account

Microsoft Office 365


Microsoft account

Microsoft Office 365

For an Internet-facing deployment (IFD) and on-premises installations, the Web service URL has the following form:

http[s]://< hostname[:port]>/XRMServices/2011/Discovery.svc

Consult the Developer Resources page in the Microsoft Dynamics CRM Web application for the correct URL of your installation.

To use the IDiscoveryService Web service, add a reference to the Microsoft.Xrm.Sdk.dll assembly to your Microsoft Visual Studio project, and then add a using or imports statement to access the Microsoft.Xrm.Sdk.Discovery namespace. Alternatively, you can add the service references for the URLs described previously to your project.

In This Section

Related Sections

Microsoft Dynamics CRM 2011
Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.

Community Additions