Facebook API Original

User /{user-id}

A user represents a person on Facebook. The /{user-id} node returns a single user.

Reading

Graph Explorer

GET /me HTTP/1.1
Host: graph.facebook.com

Permissions

The /{user-id} node has more complicated permissions requirements than other nodes in the Graph API:

• There are a number of fields called the public profile which are accessible with any valid access token.
• Other fields that have been explicitly set to public visibility can also be accessed with any valid access token.
• Fields that aren't set to public must be be requested with an access token with the relevant 'Extended Profile' permissions.

Fields

Name	Description	Type
id	The id of this person's user account. This ID is unique to each app and cannot be used across different apps. Our upgrade guide provides more info about this.	string
about	The 'about me' section of this person's profile.	string
age_range	Unspecific age range that this person's age fits into.	object
min	The lower bounds of the range for this person's age.	enum{13, 18, 21}
max	The upper bounds of the range for this person's age.	enum{17, 20, None}
bio	The person's bio.	string
birthday	This person's birthday in the format MM/DD/YYYY.	string
context	Provides access to the social context edges shown.	object
cover	Information about the person's cover photo	CoverPhoto
currency	This person's local currency information	object
education	The sections of a person's education history.	object[]
email	This person's primary email address listed on their profile. This field will not be returned if no valid email address is available.	string
favorite_athletes	Facebook Pages representing athletes listed under the Likes section of this person's profile.	Page[]
favorite_teams	Facebook Pages representing sports teams listed under the Likes section of this person's profile.	Page[]
first_name	The person's first name	string
gender	The gender pronoun selected by this person. This is omitted if that pronoun is a custom value.	string
hometown	The person's hometown	Page
inspirational_people	Facebook Pages representing inspirational people listed under the Likes section of this person's profile.	Page[]
installed	Is the app making the request installed?	bool
is_verified	People with large numbers of followers can have the authenticity of their identity manually verified by Facebook. This field indicates whether the user profile is verified in this way.	bool
languages	Facebook Pages representing the languages this person knows.	Page[]
last_name	The person's last name.	string
link	A link to the person's profile.	string
locale	The person's locale.	string
location	The person's current location as entered by them on their profile. This is not a check in field.	Page
middle_name	The person's middle name.	string
name	The person's full name	string
name_format	The person's name formatted to correctly handle Chinese, Japanese, Korean ordering	string
political	The person's political views	string
quotes	The person's favorite quotes	string
relationship_status	The person's relationship status	string
religion	The person's religion	string
significant_other	The person's significant other	User
timezone	The user's current timezone offset from UTC.	int
third_party_id	A string containing an anonymous, but unique identifier for this person. You can use this identifier with third-parties	string
verified	Indicates whether the user account has been verified. This is distinct from the is_verified field. Someone is considered verified if they take any of the following actions: Register for mobile Confirm their account via SMS Enter a valid credit card	bool
website	The person's website	string
work	The periods of a person's employment history.	object[]

Publishing, Updating and Deletion

You can't perform these operations on this node.

Edges

Name	Description
/accounts	The Facebook Pages of which this person is an admin.
/achievements	The achievements this person has received from Facebook Games.
/activities	The activities listed on the person's profile.
/adaccounts	The advertising accounts to which this person has access.
/albums	The photo albums this person has created.
/applications/developer	List of apps of which this person is a developer.
/apprequests	This person's outstanding requests from an app.
/books	The books listed on this profile.
/events	The events this person is attending.
/family	The person's family relationships
/feed	The posts and links published by this person or others on their profile.
/friendlists	This person's friend lists.
/friendrequests	The person's incoming friend requests.
/friends	This person's friends.
/games	Liked Games this person has added to their profile.
/groups	The Facebook Groups that the person belongs to.
/home	The person's news feed.
/ids_for_business	Business entities can claim ownership of multiple apps using the Business Manager - this edge returns the list of IDs that this user has in any of those other apps.
/inbox	The threads in this person's inbox.
/interests	The interests listed on the person's profile.
/invitable_friends	A list of friends that can be invited to install a Facebook Canvas app.
/likes	All the pages this person has liked.
/links	This is a duplicate of the /feeds edge which only shows posts of type link published by the user themselves.
/locations	A feed of posts and photos that include location information and in which this person has been tagged.
/movies	The movies listed on the person's profile.
/music	The music listed on the person's profile.
/notifications	App notifications for this person.
/outbox	The messages in this person's outbox.
/payment_transactions	The Facebook Payments orders this person placed with an app.
/payments	Deprecated endpoint for Facebook Credits product. UseFacebook Payments instead.
/permissions	The permissions that person has granted the app.
/picture	The person's profile picture.
/photos	Photos this person is tagged in.
/photos/uploaded	Similar to /photos except shows all photos this person has uploaded.
/pokes	The person's pokes.
/posts	This is a duplicate of the /feeds edge which only shows posts published by the person themselves.
/scores	The scores this person has received from Facebook Games that they've played.
/statuses	This is a duplicate of the /feeds edge which only shows status update posts published by the person themselves.
/taggable_friends	Friends that can be tagged in content published via the Graph API.
/tagged	This is a duplicate of the /feeds edge which only shows posts in which the person is tagged.
/tagged_places	List of tags of this person at a place in a photo, video, post, status or link.
/television	The television listed on the person's profile.
/videos	The videos this person has been tagged in.
/videos/uploaded	Similar to /videos except shows all videos this person has uploaded.