Welcome, Guest Sign In | Sign Up | Help
Upcoming API Documentation
Currently, the use of these APIs are restricted to non-commercial use only. If you'd like to use it for commercial purposes, please contact us first.
group.getEvents [HTTP GET]
Retrieve group event information and metadata for any public group or private group that the authenticated user is a member of.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

token (Optional)
An authentication token. (What's this?)

group_id (Numeric, Required)
The group id requested.

eventsPerPage (Numeric, Optional)
To restrict the number of members per page of results.

page (Numeric, Optional)
Page # to return. Starts with 1.

order (Either 'event_time' or 'time_added', default: 'event_time')
Event_time orders by event start date, time_added orders by the time the event was added to the group.

dir (Either 'asc' or 'desc', default: asc)
Sort direction.

show_past (Either 1 or 0, default: 0)
Whether to exclusively show past results (instead of upcoming) in the event results.

Example Response
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
<event id="90305" name="SXSW Interactive Festival"
    start_date="2007-03-09" end_date="2007-03-14"
    start_time="10:00:00" end_time="17:00:00" description="The south
    by southwest interactive festival" personal="0" selfpromotion="0"
    metro_id="70" venue_id="799" venue_name="Austin Convention
    Center" user_id="7302" category_id="7" date_posted="2006-07-09"
    comment_count="16" watchlist_count="378" short_start_date="Mar
    09" venue_address="500 E Cesar Chavez Street" venue_city="Austin"
    venue_state_name="Texas" venue_state_code="tx"
    venue_state_id="44" venue_country_name="United States"
    venue_country_code="us" venue_country_id="1" venue_zip="78701"
    venue_url="http://www.austinconventioncenter.com/"
    venue_phone="(512) 476-5461"/> 
</rsp>
		
Error Codes (sent in HTTP Response Header)
403 Not Authorized:
  • Missing valid authentication parameters - Please pass an authentication token to the method.
  • Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.

404 Not Found:
  • Missing valid api_key - Please create an API key using the above link.
  • Your api_key is inactive or not found - Please contact us for support.
  • Invalid group_id parameter.
  • You are not a member of this private group.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board