GetFederationInformation operation (SOAP)
Last modified: July 01, 2013
Applies to: Exchange Online | Exchange Server 2010 | Exchange Server 2013 | Office 365
The GetFederationInformation operation provides information about the federation status of the organization, such as the target URI to be used when requesting tokens that are targeted at this organization, and the other domains that the organization has also federated.
Only federated organizations can share calendar, contacts, and messages to external users.
Description
The following example of a GetFederationInformation request shows a request for a user’s federation information. The client sends this request to the server.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:exm="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:ext="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:a="http://www.w3.org/2005/08/addressing"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<a:MessageID>urn:uuid:6389558d-9e05-465e-ade9-aae14c4bcd10</a:MessageID>
<a:Action soap:mustUnderstand="1">http://schemas.microsoft.com/
exchange/2010/Autodiscover/Autodiscover/GetFederationInformation
</a:Action>
<a:To soap:mustUnderstand="1">https://autodiscover.byfcxu-
dom.extest.microsoft.com/autodiscover/autodiscover.svc</a:To>
<a:ReplyTo>
<a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address>
</a:ReplyTo>
</soap:Header>
<soap:Body>
<GetFederationInformationRequestMessage
xmlns="http://schemas.microsoft.com/exchange/2010/Autodiscover">
<Request>
<Domain>contoso.com</Domain>
</Request>
</GetFederationInformationRequestMessage>
</soap:Body>
</soap:Envelope>
Request Elements
The following elements are used in the request:
Description
The following example shows a successful response to the GetFederationInformation request that the server sends to the client.
Code
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:a="http://www.w3.org/2005/08/addressing">
<s:Header>
<a:Action s:mustUnderstand="1">
http://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetFederationInformationResponse
</a:Action>
<a:RelatesTo>urn:uuid:6389558d-9e05-465e-ade9-aae14c4bcd10</a:RelatesTo>
</s:Header>
<s:Body>
<GetFederationInformationResponseMessage xmlns="http://schemas.microsoft.com/exchange/2010/Autodiscover">
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ErrorCode>NoError</ErrorCode>
<ErrorMessage/>
<ApplicationUri>BYFCXU-DOM.EXTEST.MICROSOFT.COM</ApplicationUri>
<Domains>
<Domain>contoso.com</Domain>
<Domain>europe.contoso.com</Domain>
<Domain>americas.contoso.com</Domain>
<Domain>contosolive.com</Domain>
</Domains>
</Response>
</GetFederationInformationResponseMessage>
</s:Body>
</s:Envelope>
Response Elements
The following elements are used in the response: