Table of contents

Classes (1):

user

Properties (82):

about, accounts, activities, adaccounts, address, albums, apprequests, bio, birthday, books, checkins, cover, currency, devices, education, email, events, family, favorite_athletes, favorite_teams, feed, first_name, friendlists, friendrequests, friends, games, gender, groups, home, hometown, id, inbox, inspirational_people, install_type, installed, interested_in, interests, is_eligible_promo, languages, last_name, likes, link, links, locale, location, locations, meeting_for, middle_name, movies, music, mutualfriends, name, notes, notifications, outbox, payment_pricepoints, payments, permissions, photos, picture, political, posts, quotes, relationship_status, religion, scores, security_settings, significant_other, sports, statuses, tagged, television, third_party_id, timezone, updated_time, updates, username, verified, video_upload_limits, videos, website, work


Classes

user

Properties

about, accounts, activities, adaccounts, address, albums, apprequests, bio, birthday, books, checkins, cover, currency, devices, education, email, events, family, favorite_athletes, favorite_teams, feed, first_name, friendlists, friendrequests, friends, games, gender, groups, home, hometown, id, inbox, inspirational_people, install_type, installed, interested_in, interests, is_eligible_promo, languages, last_name, likes, link, links, locale, location, locations, meeting_for, middle_name, movies, music, mutualfriends, name, notes, notifications, outbox, payment_pricepoints, payments, permissions, photos, picture, political, posts, quotes, relationship_status, religion, scores, security_settings, significant_other, sports, statuses, tagged, television, third_party_id, timezone, updated_time, updates, username, verified, video_upload_limits, videos, website, work

about (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#about

The domain of this property is user

accounts (Property) object property Definition

The Facebook apps and pages owned by the current user.

Definition

The URI of this property is http://graph.facebook.com/schema/user#accounts

This property is a object property.


The domain of this property is user

activities (Property) object property Definition

The activities listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#activities

This property is a object property.


The domain of this property is user

adaccounts (Property) object property Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#adaccounts

This property is a object property.


The domain of this property is user

address (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#address

The domain of this property is user

albums (Property) object property Definition

The photo albums this user has created.

Definition

The URI of this property is http://graph.facebook.com/schema/user#albums

This property is a object property.


The domain of this property is user

apprequests (Property) object property Definition

The user's outstanding requests from an app.

Definition

The URI of this property is http://graph.facebook.com/schema/user#apprequests

This property is a object property.


The domain of this property is user

bio (Property) Definition

The user's biography. `user_about_me` or `friends_about_me`. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#bio

The domain of this property is user

birthday (Property) Definition

The user's birthday. `user_birthday` or `friends_birthday`. Date `string` in `MM/DD/YYYY` format.

Definition

The URI of this property is http://graph.facebook.com/schema/user#birthday

The domain of this property is user

books (Property) object property Definition

The books listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#books

This property is a object property.


The domain of this property is user

checkins (Property) object property Definition

The places that the user has checked-into.

Definition

The URI of this property is http://graph.facebook.com/schema/user#checkins

This property is a object property.


The domain of this property is user

cover (Property) Definition

The user's cover photo (must be explicitly requested using `fields=cover` parameter). No access token required. `array` of fields `id`, `source`, and `offset_y`

Definition

The URI of this property is http://graph.facebook.com/schema/user#cover

The domain of this property is user

currency (Property) Definition

The user's currency settings (must be explicitly requested using a `fields=currency` URL parameter). Requires access token. `object` with fields `currency` (detailed [here](/docs/credits/user_currency/)), `id`

Definition

The URI of this property is http://graph.facebook.com/schema/user#currency

The domain of this property is user

devices (Property) Definition

A list of the user's devices beyond desktop. User `access_token` required; only available for friends of the current user. `array` of objects containing `os` which may be a value of 'iOS' or 'Android', along with an additional field `hardware` which may be a value of 'iPad' or 'iPhone' if present, however may not be returned if we are unable to determine the hardware model - Note: this is a non-default field and must be explicitly specified as shown below

Definition

The URI of this property is http://graph.facebook.com/schema/user#devices

The domain of this property is user

education (Property) Definition

A list of the user's education history. `user_education_history` or `friends_education_history`. `array` of objects containing `year` and `type` fields, and `school` object (`name`, `id`, `type`, and optional `year`, `degree`, `concentration` array, `classes` array, and `with` array ).

Definition

The URI of this property is http://graph.facebook.com/schema/user#education

The domain of this property is user

email (Property) Definition

The proxied or contact email address granted by the user. `email`. `string` containing a valid RFC822 email address.

Definition

The URI of this property is http://graph.facebook.com/schema/user#email

The domain of this property is user

events (Property) object property Definition

The events this user is attending.

Definition

The URI of this property is http://graph.facebook.com/schema/user#events

This property is a object property.


The domain of this property is user

family (Property) object property Definition

The user's family relationships

Definition

The URI of this property is http://graph.facebook.com/schema/user#family

This property is a object property.


The domain of this property is user

favorite_athletes (Property) Definition

The user's favorite athletes; this field is deprecated and will be removed in the near future. `user_likes` or `friends_likes` . `array` of objects containing `id` and `name` fields.

Definition

The URI of this property is http://graph.facebook.com/schema/user#favorite_athletes

The domain of this property is user

favorite_teams (Property) Definition

The user's favorite teams; this field is deprecated and will be removed in the near future. `user_likes` or `friends_likes`. `array` of objects containing `id` and `name` fields.

Definition

The URI of this property is http://graph.facebook.com/schema/user#favorite_teams

The domain of this property is user

feed (Property) object property Definition

The user's wall.

Definition

The URI of this property is http://graph.facebook.com/schema/user#feed

This property is a object property.


The domain of this property is user

first_name (Property) Definition

The user's first name. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#first_name

The domain of this property is user

friendlists (Property) object property Definition

The user's friend lists.

Definition

The URI of this property is http://graph.facebook.com/schema/user#friendlists

This property is a object property.


The domain of this property is user

friendrequests (Property) object property Definition

The user's incoming friend requests.

Definition

The URI of this property is http://graph.facebook.com/schema/user#friendrequests

This property is a object property.


The domain of this property is user

friends (Property) object property Definition

The user's friends.

Definition

The URI of this property is http://graph.facebook.com/schema/user#friends

This property is a object property.


The domain of this property is user

games (Property) object property Definition

Games the user has added to the Arts and Entertainment section of their profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#games

This property is a object property.


The domain of this property is user

gender (Property) Definition

The user's gender: `female` or `male`. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#gender

The domain of this property is user

groups (Property) object property Definition

The Groups that the user belongs to.

Definition

The URI of this property is http://graph.facebook.com/schema/user#groups

This property is a object property.


The domain of this property is user

home (Property) object property Definition

The user's news feed.

Definition

The URI of this property is http://graph.facebook.com/schema/user#home

This property is a object property.


The domain of this property is user

hometown (Property) Definition

The user's hometown. `user_hometown` or `friends_hometown`. object containing `name` and `id`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#hometown

The domain of this property is user

id (Property) datatype property inverse functional property Definition

The user's Facebook ID. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#id

This property is a inverse functional, data property.


The domain of this property is user
The range of this property is xsd:string

inbox (Property) object property Definition

The [Threads](/docs/reference/api/thread/) in this user's inbox.

Definition

The URI of this property is http://graph.facebook.com/schema/user#inbox

This property is a object property.


The domain of this property is user

inspirational_people (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#inspirational_people

The domain of this property is user

install_type (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#install_type

The domain of this property is user

installed (Property) Definition

Specifies whether the user has installed the application associated with the app access token that is used to make the request; only returned if specifically requested via the `fields` URL parameter. Requires app `access_token`. `object` containing `type` (this is always "user"), `id` (the ID of the user), and optional `installed` field (always `true` if returned); The `installed` field is only returned if the user has installed the application, otherwise it is not part of the returned object.

Definition

The URI of this property is http://graph.facebook.com/schema/user#installed

The domain of this property is user

interested_in (Property) Definition

The genders the user is interested in. `user_relationship_details` or `friends_relationship_details`. `array` containing strings.

Definition

The URI of this property is http://graph.facebook.com/schema/user#interested_in

The domain of this property is user

interests (Property) object property Definition

The interests listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#interests

This property is a object property.


The domain of this property is user

is_eligible_promo (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#is_eligible_promo

The domain of this property is user

languages (Property) Definition

The user's languages. `user_likes`. `array` of objects containing language `id` and `name`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#languages

The domain of this property is user

last_name (Property) Definition

The user's last name. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#last_name

The domain of this property is user

likes (Property) object property Definition

All the pages this user has liked.

Definition

The URI of this property is http://graph.facebook.com/schema/user#likes

This property is a object property.


The domain of this property is user

link (Property) Definition

The URL of the profile for the user on Facebook. No `access_token` required. `string` containing a valid URL.

Definition

The URI of this property is http://graph.facebook.com/schema/user#link

The domain of this property is user

links (Property) object property Definition

The user's posted links.

Definition

The URI of this property is http://graph.facebook.com/schema/user#links

This property is a object property.


The domain of this property is user

locale (Property) Definition

The user's locale. No `access_token` required. `string` containing the ISO Language Code and ISO Country Code.

Definition

The URI of this property is http://graph.facebook.com/schema/user#locale

The domain of this property is user

location (Property) Definition

The user's current city. `user_location` or `friends_location`. object containing `name` and `id`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#location

The domain of this property is user

locations (Property) object property Definition

Posts, statuses, and photos in which the user has been tagged at a location, or where the user has authored content (i.e. this excludes objects with no location information, and objects in which the user is not tagged). See documentation of the [`location_post`](/docs/reference/fql/location_post/) table for more detailed information on permissions.

Definition

The URI of this property is http://graph.facebook.com/schema/user#locations

This property is a object property.


The domain of this property is user

meeting_for (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#meeting_for

The domain of this property is user

middle_name (Property) Definition

The user's middle name. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#middle_name

The domain of this property is user

movies (Property) object property Definition

The movies listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#movies

This property is a object property.


The domain of this property is user

music (Property) object property Definition

The music listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#music

This property is a object property.


The domain of this property is user

mutualfriends (Property) object property Definition

The mutual friends between two users.

Definition

The URI of this property is http://graph.facebook.com/schema/user#mutualfriends

This property is a object property.


The domain of this property is user

name (Property) Definition

The user's full name. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#name

The domain of this property is user

notes (Property) object property Definition

The user's notes.

Definition

The URI of this property is http://graph.facebook.com/schema/user#notes

This property is a object property.


The domain of this property is user

notifications (Property) object property Definition

The notifications for the user.

Definition

The URI of this property is http://graph.facebook.com/schema/user#notifications

This property is a object property.


The domain of this property is user

outbox (Property) object property Definition

The messages in this user's outbox.

Definition

The URI of this property is http://graph.facebook.com/schema/user#outbox

This property is a object property.


The domain of this property is user

payment_pricepoints (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#payment_pricepoints

The domain of this property is user

payments (Property) object property Definition

The Facebook Credits orders the user placed with an application. See the [Credits API](/docs/creditsapi) for more information.

Definition

The URI of this property is http://graph.facebook.com/schema/user#payments

This property is a object property.


The domain of this property is user

permissions (Property) object property Definition

The permissions that user has granted the application.

Definition

The URI of this property is http://graph.facebook.com/schema/user#permissions

This property is a object property.


The domain of this property is user

photos (Property) object property Definition

Photos the user (or friend) is tagged in.

Definition

The URI of this property is http://graph.facebook.com/schema/user#photos

This property is a object property.


The domain of this property is user

picture (Property) object property Definition

The user's profile picture.

Definition

The URI of this property is http://graph.facebook.com/schema/user#picture

This property is a object property.


The domain of this property is user

political (Property) Definition

The user's political view. `user_religion_politics` or `friends_religion_politics`. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#political

The domain of this property is user

posts (Property) object property Definition

The user's own posts.

Definition

The URI of this property is http://graph.facebook.com/schema/user#posts

This property is a object property.


The domain of this property is user

quotes (Property) Definition

The user's favorite quotes. `user_about_me` or `friends_about_me`. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#quotes

The domain of this property is user

relationship_status (Property) Definition

The user's relationship status: `Single`, `In a relationship`, `Engaged`, `Married`, `It's complicated`, `In an open relationship`, `Widowed`, `Separated`, `Divorced`, `In a civil union`, `In a domestic partnership`. `user_relationships` or `friends_relationships`. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#relationship_status

The domain of this property is user

religion (Property) Definition

The user's religion. `user_religion_politics` or `friends_religion_politics` . `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#religion

The domain of this property is user

scores (Property) object property Definition

The current [scores](/docs/score/) for the user in games.

Definition

The URI of this property is http://graph.facebook.com/schema/user#scores

This property is a object property.


The domain of this property is user

security_settings (Property) Definition

Information about security settings enabled on the user's account (must be explicitly requested using a `fields=security_settings` URL parameter). Available only for the current user . `object` containing `secure_browsing` (an object with a single field, `enabled`, which indicates whether Secure Browsing is enabled).

Definition

The URI of this property is http://graph.facebook.com/schema/user#security_settings

The domain of this property is user

significant_other (Property) Definition

The user's significant other. `user_relationships` or `friends_relationships`. object containing `name` and `id`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#significant_other

The domain of this property is user

sports (Property) Definition

{{No description available}} info

Definition

The URI of this property is http://graph.facebook.com/schema/user#sports

The domain of this property is user

statuses (Property) object property Definition

The user's status updates.

Definition

The URI of this property is http://graph.facebook.com/schema/user#statuses

This property is a object property.


The domain of this property is user

tagged (Property) object property Definition

Posts the user is tagged in.

Definition

The URI of this property is http://graph.facebook.com/schema/user#tagged

This property is a object property.


The domain of this property is user

television (Property) object property Definition

The television listed on the user's profile.

Definition

The URI of this property is http://graph.facebook.com/schema/user#television

This property is a object property.


The domain of this property is user

third_party_id (Property) Definition

An anonymous, but unique identifier for the user; only returned if specifically requested via the `fields` URL parameter. Requires `access_token`. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#third_party_id

The domain of this property is user

timezone (Property) Definition

The user's timezone offset from UTC. Available only for the current user. `number`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#timezone

The domain of this property is user

updated_time (Property) datatype property Definition

The last time the user's profile was updated; changes to the `languages`, `link`, `timezone`, `verified`, `interested_in`, `favorite_athletes`, `favorite_teams`, and `video_upload_limits` are not not reflected in this value. Requires `access_token`. `string` containing an ISO-8601 datetime.

Definition

The URI of this property is http://graph.facebook.com/schema/user#updated_time

This property is a data property.


The domain of this property is user
The range of this property is xsd:dateTime

updates (Property) object property Definition

The updates in this user's inbox.

Definition

The URI of this property is http://graph.facebook.com/schema/user#updates

This property is a object property.


The domain of this property is user

username (Property) Definition

The user's Facebook username. No `access_token` required. `string`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#username

The domain of this property is user

verified (Property) Definition

The user's account verification status, either `true` or `false` (see below). Requires `access_token`. `boolean`.

Definition

The URI of this property is http://graph.facebook.com/schema/user#verified

The domain of this property is user

video_upload_limits (Property) Definition

The size of the video file and the length of the video that a user can upload; only returned if specifically requested via the `fields` URL parameter. Requires `access_token`. object containing `length` and `size` of video.

Definition

The URI of this property is http://graph.facebook.com/schema/user#video_upload_limits

The domain of this property is user

videos (Property) object property Definition

The videos this user has been tagged in.

Definition

The URI of this property is http://graph.facebook.com/schema/user#videos

This property is a object property.


The domain of this property is user

website (Property) Definition

The URL of the user's personal website. `user_website` or `friends_website` . `string` containing a valid URL.

Definition

The URI of this property is http://graph.facebook.com/schema/user#website

The domain of this property is user

work (Property) Definition

A list of the user's work history. `user_work_history` or `friends_work_history`. `array` of objects containing `employer`, `location`, `position`, `start_date` and `end_date` fields.

Definition

The URI of this property is http://graph.facebook.com/schema/user#work

The domain of this property is user
feedback

bug Report a bug

request Request a feature

mail list Join the user mail list