Retrieving a profile entry
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 stars1 comment

To retrieve a profile entry document, use the web address found in the entry's edit link in the profile service document.

You can only retrieve the profile entry for the user whose credentials you use to authenticate the request. In other words, you can only retrieve your own profile entry document or someone else's if that person provides you with his authentication credentials.

To find the endpoint to retrieve a users profile entry document follow the steps below:

1. Get the service document for the person's profile. See Retrieving the Profiles service document
2. Obtain the value of the href attribute within the collection element. The link will contain "/atom/". Perform a GET request with this link.
3. Inside the feed from step 2, find the "" link where the rel attribute has the value "edit". Perform a GET request with this link.

Here is an example of the link:

You can use this operation to obtain profile entry information that you want to preserve prior to performing an update. See Updating profile entries for more information. This method returns the Atom entry of a single profile as opposed to a feed of a profile or set of profiles.

The URI is the value of the href attribute of the element of the user's profile entry

Tip: If you want to edit the value of fields in a person's profile, get the rel="edit" link for a specific person's profile. To do so, retrieve a feed of the profile and specify the output=vcard parameter on the request.

Method URI Description
GET /profiles/atom/ Value of the href attribute of the <link> element with the rel="edit" attribute in the user's profile feed.
Name Type Optional Description
string No An ID generated by Profiles to identify a person.
Content Type: application/atom+xml
Code Description
OK. Indicates that the request was received successfully.
Forbidden. The server refuses to fulfill a request, typically because the request was for an object that you don't have permission to access.
URL could not be found
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
Philippe Riand commented on Jun 25, 2016

Re: Retrieving a profile entry