Text of developers.facebook.com › docs › graph-api › reference › user as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Graph API User - Documentation - Meta for Developers

Graph API Overview Get Started Batch Requests Debug Requests Handle Errors Field Expansion Secure Requests Changelog Reference Graph API Version v27.0 User Represents a Facebook user. Reading Get fields and edges on a User. Requirements Type Description Access Tokens User Permissions public_profile New Page Experience This endpoint is supported for New Page Experience . Example Graph API Explorer GET /v27.0/{person-id}/ HTTP/1.1 Host: graph.facebook.com /* PHP SDK v5.0.0 */ /* make the API call */ try { // Returns a `Facebook\FacebookResponse` object $response = $fb->get( '/{person-id}/', '{access-token}' ); } catch(Facebook\Exceptions\FacebookResponseException $e) { echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(Facebook\Exceptions\FacebookSDKException $e) { echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } $graphNode = $response->getGraphNode(); /* handle the result */ /* make the API call */ FB.api( "/{person-id}/", function (response) { if (response && !response.error) { /* handle the result */ } } ); /* make the API call */ new GraphRequest( AccessToken.getCurrentAccessToken(), "/{person-id}/", null, HttpMethod.GET, new GraphRequest.Callback() { public void onCompleted(GraphResponse response) { /* handle the result */ } } ).executeAsync(); /* make the API call */ FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc] initWithGraphPath:@"/{person-id}/" parameters:params HTTPMethod:@"GET"]; [request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) { // Handle the result }]; curl -X GET -G \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v27.0/{person-id}/ If you want to learn how to use the Graph API, read our Using Graph API guide .

Default Public Profile Fields The public_profile permission allows apps to read the following fields: id first_name last_name middle_name name name_format picture short_name Parameters This endpoint doesn't have any parameters. Fields Field Description id numeric string The app user's App-Scoped User ID. This ID is unique to the app and cannot be used by other apps. Core about string Returns no data as of April 4, 2018. age_range AgeRange The age segment for this person expressed as a minimum and maximum age.

For example, more than 18, less than 21. Core birthday string The person's birthday. This is a fixed format string, like MM/DD/YYYY . However, people can control who can see the year they were born separately from the month and day so this string can be only the year (YYYY) or the month + day (MM/DD) Core client_business_id numeric string The client's Business ID associated with a Business Integration System User. education list<EducationExperience> Returns no data as of April 4, 2018. email string The User's primary email address listed on their profile.

This field will not be returned if no valid email address is available. Core favorite_athletes list<Experience> Athletes the User likes. favorite_teams list<Experience> Sports teams the User likes. first_name string The person's first name Core gender string The gender selected by this person, male or female . If the gender is set to a custom value, this value will be based off of the selected pronoun; it will be omitted if the pronoun is neutral.

Core hometown Page The person's hometown inspirational_people list<Experience> The person's inspirational people installed bool Is the app making the request installed is_guest_user bool if the current user is a guest user. should always return false. languages list<Experience> Facebook Pages representing the languages this person knows last_name string The person's last name Core link string A link to the person's Timeline.

The link will only resolve if the person clicking the link is logged into Facebook and is a friend of the person whose profile is being viewed. Core local_news_megaphone_dismiss_status bool Display megaphone for local news bookmark Deprecated local_news_subscription_status bool Daily local news notification Deprecated locale string The person's locale Core Deprecated location Page The person's current location as entered by them on their profile.

This field requires the user_location permission. Core meeting_for list<string> What the person is interested in meeting for middle_name string The person's middle name Core name string The person's full name Core Default name_format string The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering political string Returns no data as of April 4, 2018. quotes string The person's favorite quotes relationship_status string Returns no data as of April 4, 2018. religion string Returns no data as of April 4, 2018. shared_login_upgrade_required_by timestamp The time that the shared login needs to be upgraded to Business Manager by significant_other User The person's significant other sports list<Experience> Sports played by the person supports_donate_button_in_live_video bool Whether the user can add a Donate Button to their Live Videos third_party_id string A string containing an anonymous, unique identifier for the User, for use with third-parties.

Deprecated for versions 3.0+. Apps using older versions of the API can get this field until January 8, 2019. Apps installed by the User on or after May 1st, 2018, cannot get this field. Deprecated timezone float (min: -24) (max: 24) The person's current timezone offset from UTC Core Deprecated token_for_business string A token that is the same across a business's apps. Access to this token requires that the person be logged into your app or have a role on your app.

This token will change if the business owning the app changes updated_time datetime Updated time Deprecated verified bool Indicates whether the 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 Deprecated video_upload_limits VideoUploadLimits Video upload limits website string Returns no data as of April 4, 2018.

Edges Edge Description accounts Edge<Page> Pages the User has a role on. ad_studies Edge<AdStudy> Ad studies that this User's can view. albums Edge<Album> The photo albums this person has created apprequestformerrecipients Edge<AppRequestFormerRecipient> App requests apprequests Edge<AppRequest> This person's pending requests from an app Core assigned_applications Edge<Application> assigned_applications assigned_business_asset_groups Edge<BusinessAssetGroup> assigned_business_asset_groups assigned_instagram_accounts Edge<ShadowIGUser> assigned_instagram_accounts assigned_pages Edge<Page> assigned_pages assigned_product_catalogs Edge<ProductCatalog> assigned_product_catalogs assigned_whatsapp_business_accounts Edge<WhatsAppBusinessAccount> assigned_whatsapp_business_accounts business_users Edge<BusinessUser> Business users corresponding to the user businesses Edge<Business> Businesses associated with the user conversations Edge<UnifiedThread> Facebook Messenger conversation custom_labels Edge<PageUserMessageThreadLabel> custom_labels feed Edge<Post> The posts and links published by this person or others on their profile ids_for_apps Edge<UserIDForApp> Businesses can claim ownership of multiple apps using Business Manager.

This edge returns the list of IDs that this user has in any of those other apps ids_for_business Edge<UserIDForApp> Businesses can claim ownership of multiple apps using Business Manager. This edge returns the list of IDs that this user has in any of those other apps ids_for_pages Edge<UserIDForPage> Businesses can claim ownership of apps and pages using Business Manager. This edge returns the list of IDs that this user has in any of the pages owned by this business likes Edge<Page> All the Pages this person has liked live_videos Edge<LiveVideo> Live videos from this person music Edge<Page> Music this person likes payment.subsc

The rest of this page is on the live site.