Getting a list of the user's connections by status (My Connections)
Added by IBM contributorIBM | Edited by Claudia R Elbourn on July 7, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Returns a feed that lists invitations to connect by status.

 The user can use this feed to see pending invitations, unconfirmed invitations, and accepted invitations.

Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).

Method URI Description
GET /profiles/atom/ Retrieves a list of invitations by status for the person whose credentials are provided with the request.
Name Type Optional Description
string No Identifies the type of connection to look for. You must specify connectionType=colleague. Required.
string Yes Internet email address of the user whose colleagues you want to retrieve.
Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in:
Note: You must provide either this parameter or the userid parameter. Do not provide this parameter if IBM® Connections is configured to prevent email addresses from being displayed. It will return an error code. Use the key or userid parameters instead.
enumerated Yes Specifies whether you want a full profile or partial profile to be returned. Options are lite or full. The default value is lite.
Note: This can only be used when the outputType parameter is provided also and is set to profile.
Authorized values:
  • lite
  • full
boolean Yes Specifies whether or not to include the invitation message with the returned entries. This parameter accepts a Boolean value of true or false. If you include this parameter and set it to true, you must be the source of the connection object and you must authenticate the request.
boolean Yes Indicates whether or not to include the status message from the message board of each colleague represented in the returned feed. This parameter accepts the values of true or false.
string Yes An ID generated by Profiles to identify a person.
Note: A user's key value is contained in the element with a class attribute value of x-profile-key in the user's profile feed. You can access a user's feed by searching all profiles by name, which returns information you can then use to retrieve the person's feed.
enumerated Yes Specifies the output format option of the ATOM <content> element when the value of the outputType parameter is set to profile. Options are:
Produces content according to the xhtml/vcard microformat specification. hcard content is in XML format which means it can be addressed by XPath. This value is the default option.
Produces content according to the VCARD 2.1 standard. vcard content is text based, but more compact. This output format specifies the rel="edit" link element for each profile. Use this format if you want to update a profile.
Authorized values:
  • hcard
  • vcard
enumerated Yes Specifies the format in which the information is returned. Options are:
Returns colleague connection entries.
Returns profile entries.
Authorized values:
  • connection
  • profile
string Yes Includes in the resulting feed all colleague relationships established after a specified date. Specify the date using a date-time value that conforms to RFC3339. Use an upper case "T" to separate the date and time, and an uppercase "Z" in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z.
enumerated Yes Specifies the order in which to sort the results. By default, they are ordered by the date on which a person requested to connect to you. You can specify the following option:
Sorts the entries alphabetically by display name.
Authorized values:
  • displayName
  • modified
enumerated Yes Specifies the order in which to sort the results. The options are:
Sorts the results in ascending order.
Sorts the results in descending order.
Authorized values:
  • asc
  • desc
string Yes A unique ID that represents a specific person. To determine a person's user ID, you can search all profiles for the person by name. The feed that is returned identifies the person's user ID in the <snx:userid> element.
Note: You must provide either this parameter or the email parameter.
enumerated No Specifies the status of the invitation. Options are:
Lists the connections that the person was invited to participate in and has accepted.
Lists the connections that the person was invited to participate in, but has not responded to yet.
Note: You must authenticate the request when you specify this status value.
Lists the connections that the person has invited others to participate in, but that have not yet been accepted or deleted.
Note: You must authenticate the request when you specify this status value.
Authorized values:
  • accepted
  • pending
  • unconfirmed
Content Type: application/atom+xml
Code Description
OK. Indicates that the request was received successfully.