Skip to main content
GET
List poll options

Authorizations

Authorization
string
header
required

Personal API token — find yours under My Account → API.

Path Parameters

poll_id
string
required

Poll member_hash or admin_hash

Query Parameters

parent_option_id
string

Public ID of parent option id, to list its child options.

page
integer

Page to return, 1-based. Defaults to 1.

per
integer

Options per page. Defaults to the page size of the poll type. At most 100.

organization_id
string

public_id of an organization the user belongs to. When given, the request runs in that organization context instead of the personal account.

Response

options listed

id
string
required

Option public_id

public_url
string<uri>
required
type
string
required

Option STI class

Example:

"Options::TextOption"

admin_url
string<uri> | null

Admin access only

parent_option_id
string | null
child_option_type
string | null
content
string | null
subtitle
string | null
author_name
string | null
position
integer | null
state
enum<string> | null

Collection polls only

Available options:
incoming,
investigation,
planned,
in_implementation,
rejected,
done
rank
integer | null
rating
number<float> | null
average_rating
number<float> | null
best_rating
boolean | null
selected
boolean | null
paid
boolean | null
start_date
string<date-time> | null
end_date
string<date-time> | null
created_at
string<date-time> | null
updated_at
string<date-time> | null
approval_state
enum<string> | null

Admin access only

Available options:
unreviewed,
approved,
disapproved
approval_state_updated_at
string<date-time> | null

Admin access only

archived
boolean | null

Admin access only

attachment
object | null

URLs of the file uploaded to the option, returned by both the list and the show endpoint. Only present for option types that carry an uploaded file (image, photo, audio, drawing and advent calendar options); youtube/vimeo and uploaded-video options do not have it. The attachment_url_* keys are the processed derivatives that exist for this file, so which ones are returned depends on the uploaded file: images and videos get large, thumb and social, an audio file only gets cover if it has embedded cover art, and a file that is still processing has none at all. The whole object is omitted when none of its keys apply, e.g. an option without a file or a still-processing upload you have no download access to.