Returns an array of a user’s friends.




User authentication.


Name Example Description
USER_ID HZXXY3Y Identity of the user to get friends of. Pass self to get friends of the acting user.
limit 100 Number of results to return, up to 500.
offset 100 Used to page through results.

Response Fields

Field Description
id A unique identifier for this user.
firstName A user’s first name.
lastName A user’s last name.
photo Contains prefix and suffix, similar to the format for photo. Accepted sizes are 36x36, 100x100, 300x300, and 500x500.
relationship The relationship of the acting user (me) to this user (them). One of self, friend, pendingMe (user has sent a friend request that acting user has not accepted), pendingThem (acting user has sent a friend request to the user but they have not accepted), or followingThem (acting user is following a celebrity or page). If there is no relationship or pending request between the two users, the node is absent. If the acting user is a celebrity, does not indicate whether the user is following them. If pendingMe, applications will want to the acting user to an approve/ignore action. If pendingThem, applications will want to show the acting user a “pending” message.
friends Contains count of friends for this user and groups of users who are friends. Right now will only contain a group where type is friends, but it’s subject to change.
type Present for non-standard user types. One of page, chain, celebrity, or venuePage. Pages are brand pages, such as Bravo, chains are pages that own a set of venues, like Starbucks, celebrities are users that other users can follow, like Mario Batali, and venuePages represent single venues creating content, such as My ArenA creating updates. venuePage’s do not really have a user profile, show the veue page instead.
venue For venuePage users, this field just contains an id for the relevant venue.
homeCity User’s home city
gender male, female, or none
contact An object containing none, some, or all of twitter, facebook, email, and phone. Both are strings.
bio A short bio for the user.
tips In compact users, if present, contains the count of tips from this user. In full users, contains count and an array of selected tips as items, which may or may not be empty.
lists If this user has lists, groups contains created for lists created by this user. In compact, just the count is provided, and in full, some sample lists are included. In full form, lists also contains a count of the lists created and followed by this user. Full set of items at users/XXX/lists
followers If this user can have followers (i.e. it’s a celebrity, venue, or page), contains count of followers for this user in compact, and, in detail, groups of users who follow this user, split into friends and others.
following groups of pages this user has followed.
mayorships Contains the count of mayorships for this user and an items array that for now is empty. Use users/USER_ID/mayorships to get actual mayorships.
photos Contains the count of photos this user has. May contain an array of selected photos as items, full set of items at users/USER_ID/photos, but only visible to self.
scores Contains recent, max, checkinsCount, and goal for showing user’s current game status.
checkins Contains the count of checkins by this user. May contain the most recent checkin as an array items containing a single element, if the user is a friend. Users can fetch users/USER_ID/checkins for their own complete history.
pings Whether we receive pings from this user, if we have a relationship.
requests Contains count of pending friend requests for this user.
Was this page helpful?
Thank you!