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
    • 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

notification

API Reference › FQL › notification

Description

The current user's notifications as represented in FQL.

Columns

NameDescription

app_id

number

The ID of the application associated with the notification. This may be a third-party application or a Facebook application (for example, Wall).

body_html

string

Any additional content the notification includes, in HTML.

body_text

string

The plaintext version of body_html, with all HTML tags stripped out.

created_time

number

The time the notification was originally sent. Notifications older than 7 days are deleted and will not be returned via this table.

href

string

The URL associated with the notification. This is usually a location where the user can interact with the subject of the notification.

icon_url

string

The URL associated with the notification's icon.

is_hidden

number (min: 0) (max: 1)

Indicates whether the user hid the associated application's notifications.

is_unread

number

Indicates whether the notification has been marked as read. Use notifications.markRead to mark a notification as read.

notification_id

numeric string

The ID of the notification. This ID is not globally unique, so the recipient_id must be specified in addition to it.

object_id

string

The object id of the notification.

object_type

string

The object type (e.g. stream, photo, event etc.) of the notification.

recipient_id

number

The user ID of the recipient of the notification. It is always the current session user.

sender_id

number

The user ID of the sender of the notification.

title_html

string

The main body of the notification in HTML.

title_text

string

The plaintext version of title_html, with all HTML tags stripped out.

updated_time

number

The time the notification was originally sent, or the time the notification was updated, whichever is later.

Examples

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

Permissions

To read the notification table you need manage_notifications [permissions][1].

Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy