Retrieving community events
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 9, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Get a list of community events, from a given community, or by event creator. This method returns the Atom document that contains a list of community events.
Tags: commapi

Request parameters

You can use one or more of the input parameters to limit the number of events returned in the feed. Separate multiple parameters with an ampersand (&).

Note: This request will return a list of community events, in their created date descending order.

Input
Method URI Description
GET /communities/calendar/atom/calendar/event Value of the href attribute of <collection title="Event Entries"> element in User's Service Document
Name Type Optional Description
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of events to return per page. The default value is 10. The maximum value you can specify is 100.
calendarUuid
string No The uuid of community that you want to query about. This is a mandatory parameter, if "userid" parameter is not provided.
userid
string Yes The uuid of user that you want to query about. If this parameter is provided, it will only return those community events that created by the specific user.
tags
string Yes Return community events with the specified tags. Separate multiple tags with a plus sign (+).
type
enumerated No Mandatory parameter, must be 'event'
Authorized values:
  • event
Output
Content Type: application/atom+xml
Code Description
200
Indicates that the community events were successfully found and returned. If an error occurs, this header will contain one of the error codes below.
400
Bad Request.
401
Unauthorized.
403
Forbidden.
404
Not Found.