event

Description

An FQL table that returns information about an event.

Columns

Name

Description

all_members_count

unsigned int32

The number of invitees to the event

attending_count

unsigned int32

The number of invitees who have accepted the event invite

can_invite_friends

bool

Whether the viewer can invite friends to the event

creator

Creator of the event

creator_cursor

string

The cursor for the creator index

declined_count

unsigned int32

The number of invitees who have declined the event invite

description

string

Description of the event

eid

ID of the event

end_time

string

End time of the event (UNIX timestamp)

has_profile_pic

bool

Whether the event has a profile picture

hide_guest_list

bool

Whether the guest list is hidden for the event

host

string

Host of the event

is_date_only

bool

Whether the event only has a date specified

location

string

Location of the event

name

string

Name of the event

not_replied_count

unsigned int32

The number of invitees who have not yet replied to the event invite

parent_group_id

numeric string

The group the event belongs to

pic

string

Event picture

pic_big

string

Large event picture

pic_cover

struct

Cover picture of Event

cover_id id	The ID of the cover photo
source string	The source of the cover photo
offset_y float	When non-zero, cover image overflows vertically. Value indicates the offset percentage of the total image height from top [0-100]
offset_x float	When non-zero, cover image overflows horizontally. Value indicates the offset percentage of the total image width from left [0-100]

pic_small

string

Small event picture

pic_square

string

Square event picture

privacy

string

Privacy of the event

start_time

string

Start time of the event (UNIX timestamp)

ticket_uri

string

The link users can visit to buy a ticket to the event

timezone

string

Timezone of the event

unsure_count

unsigned int32

The number of invitees who have responded maybe to the event invite

update_time

timestamp

Last update time of the event (UNIX timestamp)

venue

struct

Venue hosting the event

street string	Street of the location
city string	City of the location
state string	State of the location
country string	Country of the location
zip string	Zip code of the location
latitude float	Latitude of the location
longitude float	Longitude of the location
id id	ID of the location
name string	Name of the location
located_in id	ID of the parent location of this location

version

unsigned int32

Version of the event

Examples

SELECT ... FROM event WHERE creator = A
SELECT ... FROM event WHERE eid = A
SELECT ... FROM event WHERE name = A

Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read the event table you need:

a generic access_token for public events (those whose privacy is set to OPEN)
a user access_token with user_event permission for a user who can see the event for non-public events
an app access_token with user_event permission (for non-public events, must be the app that created the event)
a page access_token with user_event permission (for non-public events, must be the page that created the event)

Tables

event

Description

Columns

Examples

Permissions