This method provides data of all upcoming, live and completed events accessible by a user. This includes the user's own events, as well as any events that are part of Groups or Enterprise Accounts that the user belongs to. By default, the event/list request only returns events that belong to the user. To request events that belong to an Enterprise Account or Group, one of the account or group parameters must be included in the request.
In addition to the parameters listed in the Request Parameters section, the event/list method also includes the following parameters:
A pipe (|) delimited list of event types to retrieve. Possible values include:
upcoming - events that haven't started
live - events currently live
finished - completed events
The event code at which you want to start receiving events. The event code is unique and is provided in the data for any event returned. If it's not included, it will default to the earliest possible event (by creation date).
Controls the number of events that are returned. If no value is provided, the last 500 matching events will be returned in ascending order of creation date. Set event count to an integer less than 500 to limit the number of items returned. If this value is set to an integer greater than 500, only the last 500 matching items will be returned.
If the event_code parameter is also included in the request, the event_count items directly after the event with event_code will be returned. Set event_count to a negative value to return the event_count items directly before the item with item_id. For example:
Retrieve 10 oldest events - set event_count to 10 (event_count=10)
Retrieve 10 most recent events - set event_count to -10 (event_count=-10)
Retrieve 10 events that are NEWER than event with code XXX - set event_code
to XXX and event_count to 10 (event_code=XXX&event_count=10)
Retrieve 10 events that are OLDER than event with code XXX - set event_code
to XXX and event_count to -10 (event_code=XXX&event_count=-10)
The account code for which you want to retrieve events. If this parameter is provided, the group parameter should not be. If the user belongs to an Enterprise Account, this code is available on the APIs and Event Feeds page. Omit this parameter and the group parameter to retrieve events that belong to the user only.
The group code for which you want to retrieve events. If this parameter is provided, the account parameter should not be. If the user belongs to any Groups, the codes for them are available on the APIs and Event Feeds page. Omit this parameter and the account parameter to retrieve events that belong to the user only.
CoveritLive is the leading live-event publishing platform. Since its release in 2007, CoveritLive has been used by thousands of writers to engage millions of readers around the world. It is actively used both by traditional bloggers, journalists, major brands and mainstream media.