Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Media
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • Web
  • Technology Partners
  • Tables
    • album
    • app_role
    • application
    • apprequest
    • checkin
    • comment
    • comments_info
    • connection
    • cookies
    • column
    • developer
    • domain
    • domain_admin
    • event
    • event_member
    • family
    • friend
    • friendlist
    • friendlist_member
    • friend_request
    • group
    • group_member
    • insights
    • like
    • link
    • link_image_src
    • link_stat
    • location_post
    • mailbox_folder
    • message
    • note
    • notification
    • object_url
    • offsite_conversion_event
    • page
    • page_admin
    • page_blocked_user
    • page_global_brand_child
    • page_fan
    • page_milestone
    • permissions
    • permissions_info
    • photo
    • photo_src
    • photo_tag
    • place
    • privacy
    • privacy_setting
    • profile
    • profile_tab
    • profile_view
    • question
    • question_option
    • question_option_votes
    • review
    • score
    • standard_friend_info
    • standard_user_info
    • status
    • stream
    • stream_filter
    • stream_tag
    • subscription
    • table
    • thread
    • translation
    • unified_message
    • unified_message_count
    • unified_message_sync
    • unified_thread
    • unified_thread_action
    • unified_thread_count
    • unified_thread_sync
    • url_like
    • user
    • video
    • video_tag

friend_request

API Reference › FQL › friend_request

Description

An FQL table which shows the pending friend requests sent by or to the current session user.

Columns

NameDescription

is_hidden

bool

Returns true if the user has hidden the friend request. Only available if the uid_to parameter is set to the logged-in user

message

string

An optional message sent by the user with the friend request.

time

number

A UNIX timestamp indicating when the friend request was sent.

uid_from

numeric string

The ID of the user making the friend request.

uid_to

numeric string

The ID of the user receiving the friend request.

unread

(null) or (bool)

Returns true if the user has not yet seen the friend request. Only available if the uid_to parameter is set to the logged-in user

Examples

  • SELECT ... FROM friend_request WHERE uid_to = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read the friend_request table you need:

  • read_requests [permissions][1] for any friend requests that are sent by or to the current session user.
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy