Skip to content

Poll

This object contains information about a poll.

14 fields, 8 required.

Used by

Fields

id string Required
Unique poll identifier.

question string Required
Poll question, 1-300 characters.

options PollOption[] Required
List of poll options.

total_voter_count number Required
Total number of users that voted in the poll.

is_closed boolean Required
True, if the poll is closed.

is_anonymous boolean Required
True, if the poll is anonymous.

type "regular" | "quiz" Required
Poll type, currently can be “regular” or “quiz”.

allows_multiple_answers boolean Required
True, if the poll allows multiple answers.

question_entities MessageEntity[]
Special entities that appear in the question. Currently, only custom emoji entities are allowed in poll questions.

correct_option_id number
0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

explanation string
Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters.

explanation_entities MessageEntity[]
Special entities like usernames, URLs, bot commands, etc. that appear in the explanation.

open_period number
Amount of time in seconds the poll will be active after creation.

close_date number
Point in time (Unix timestamp) when the poll will be automatically closed.