In addition to the parameters listed in the Request Parameters section, the poll/list method also includes the following parameters:
The event code for the event for which poll data is being retreived. Each CiL event that is created is assigned a unique event code that identifies it in the database - The event owner can find this value after creating a new event, by selecting the "altcast_code" which is found in their Viewer Window embed code (e.g. the event code is "46e6cd22b5" in "altcast_code=46e6cd22b5"). This value is also returned by the event/list API method.
A pipe (|) delimited list of poll types to retrieve. Possible values include:
published - poll has been created
ended - poll has been closed to further votes. An event entry has been added containing final poll results.
hidden - poll has been removed from display
The poll listing data is returned in the data field of a general response. This field will consist of an array of poll objects.
Poll objects have the following fields:
The ID of the poll. Can be used in further requests against a single poll
One of: published, ended, hidden. When a poll is first created, it is in a published state. When a poll has been closed to further votes, it is in a ended state. Finally, a poll can be unpublished, which would leave it in a hidden state.
The time that the poll was published, in seconds since the Unix Epoch. The timestamp is in GMT time.
The last time that the poll was modified, in seconds since the Unix Epoch. The timestamp is in GMT time.
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.