Skip to content
dmitrig edited this page Sep 14, 2010 · 1 revision

Description: Return collection of questions or extra information
Format: XML
URL: GET /questions.xml
Parameters:

  • idea-counts: optional, boolean: If set to true, return only the current active and total idea counts
  • recent-votes: optional, boolean OR hash: If set to true or a hash with any of the following attributes, return only the number of votes submitted for each question since the beginning of the day.
    • creator_id: optional, string: Only return questions with a matching local_identifier
    • date: optional, string: Only return votes since ‘date’. Can be of the format YYYY-MM-DD.

Returns: Array of question objects

<?xml version="1.0" encoding="UTF-8"?>
<questions type="array">
  <question>
    <active type="boolean">false</active>
    <active-items-count type="integer">0</active-items-count>
    <bloom nil="true"></bloom>
    <choices-count type="integer">0</choices-count>
    <created-at type="datetime">2010-07-01T21:29:16+00:00</created-at>
    <creator-id type="integer">1</creator-id>
    <first-prompt-algorithm-id type="integer" nil="true"></first-prompt-algorithm-id>
    <id type="integer">1</id>
    <inactive-choices-count type="integer">0</inactive-choices-count>
    <information nil="true"></information>
    <it-should-autoactivate-ideas type="boolean">true</it-should-autoactivate-ideas>
    <items-count type="integer">0</items-count>
    <local-identifier nil="true"></local-identifier>
    <name>test2</name>
    <prompts-count type="integer">100</prompts-count>
    <site-id type="integer">1</site-id>
    <tracking nil="true"></tracking>
    <updated-at type="datetime">2010-07-06T12:36:10+00:00</updated-at>
    <uses-catchup type="boolean">true</uses-catchup>
    <votes-count type="integer">0</votes-count>
  </question>
  ...
</questions>

or, with idea_counts = true:

<?xml version="1.0" encoding="UTF-8"?>
<questions type="array">
  <question>
    <id type="integer">1</id>
    <active-ideas type="integer">0</active-ideas>
    <total-ideas type="integer">2</total-ideas>
  </question>
  ...
</questions>

or, with recent_votes defined:

<?xml version="1.0" encoding="UTF-8"?>
<questions type="array">
  <question>
    <id type="integer">1</id>
    <recent-votes type="integer>10</recent-votes>
  </question>
  ...
</questions>

Notes:

  • Dates are compared to the API server’s clock (i.e. the beginning of day is 12AM in the API server’s timezone)
  • Currently, if both creator_id and date are provided, date will be ignored