Community articleRetrieving a list of upcoming event instances that you are following or attending
Added by IBM contributorIBM on March 14, 2014
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 upcoming event instances, that you are following or attending.
Tags: commapi


Get a list of upcoming event instances, that you are following or attending.

This method returns the Atom document that contains a list of community event instances.

Request parameters

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

Note: This request will return a list of community event instances, in their start date ascending order.

Input

None.

Output

An Atom feed document containing the community event instance atom entries.

Input
Method URI Description
GET /communities/calendar/atom/follow This method returns the Atom document that contains a list of community event instances.
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 event instances to return per page. The default value is 10. The maximum value you can specify is 100.
startDate
string No Includes in the resulting feed all those event instances that end after a specified date. Specify the date using a date-time value that conforms to RFC3339. In addition, an uppercase "T" character must be used to separate date and time, and an uppercase "Z" character must be present in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z. This parameter is mandatory.
type
enumerated Yes "follow" or "attend". If this parameter is not specified, it will return "both followed and attended" event instances by default.
Authorized values:
  • attend
  • follow
Output
Content Type: application/atom+xml
Code Description
200
Indicates that the community event instances 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.