You can use this operation to obtain connection information that you want to preserve prior to accepting an invitation. See Accepting an invitation to become a colleague
for more information. This method returns the Atom entry of a single connection entry as opposed to a feed of all the connection entries. If you want to retrieve a feed, see Searching for a person's colleagues.
1. Retrieve any user's Profiles service document using the user's credentials to authenticate the request. See Retrieving the Profiles service document ic45
2. In the service document, find the href attribute value where the value of the rel attribute is rel="http://www.ibm.com/xmlns/prod/sn/connections/colleague"
For example: https://enterprise.example.org/profiles/atom/connections.do?connectionType=colleague&key=23e29c58-c16e-467b-8f72-d9d05fc0fef1&lastMod=1395486462948
3. Manually append the "status" attribute to the link found in step 2. The result should look similar to the following:
4. Execute the link from step 3 using the GET request method. Be sure to authenticate as the recipient of the invitation. The resulting feed will contain information about invitation status in the category element where the scheme attribute has the value "http://www.ibm.com/xmlns/prod/sn/status". For example: category term="pending" scheme="http://www.ibm.com/xmlns/prod/sn/status"
You can use this operation to obtain connection information that you want to preserve prior to accepting an invitation.