Discover the URL for your organization using the Organization Service

 

Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 365 is a multi-tenant environment—a single Microsoft Dynamics 365 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 365 (online & on-premises) 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 365 server is serving your organization at a given time.

The following table lists the Web service URLs for the worldwide Microsoft Dynamics 365 (online) data centers.

Location

Discovery Web service URL

Identity Provider

North America

https://dev.crm.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

North America 2

https://disco.crm9.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Europe, Middle East and Africa (EMEA)

https://dev.crm4.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm4.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Asia Pacific Area (APAC)

https://dev.crm5.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm5.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Oceania

https://disco.crm6.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Japan (JPN)

https://disco.crm7.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

South America

https://disco.crm2.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

India (IND)

https://disco.crm8.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Canada

https://disco.crm3.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

For an Internet-facing deployment (IFD) installation, the Web service URL has the following form:

https://dev.< hostname[:port]>/XRMServices/2011/Discovery.svc

For an on-premises installation, 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 365 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.

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

Show: