Skip to content

GiveawayWinners

This object represents a message about the completion of a giveaway with public winners.

Fields

chatChatRequired
The chat that created the giveaway
giveaway_message_idIntegerRequired
Identifier of the message with the giveaway in the chat
winners_selection_dateIntegerRequired
Point in time (Unix timestamp) when winners of the giveaway were selected
winner_countIntegerRequired
Total number of winners in the giveaway
winnersUser[]Required
List of up to 100 winners of the giveaway
additional_chat_countIntegerOptional
Optional. The number of other chats the user had to join in order to be eligible for the giveaway
prize_star_countIntegerOptional
Optional. The number of Telegram Stars that were split between giveaway winners; for Telegram Star giveaways only
premium_subscription_month_countIntegerOptional
Optional. The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only
unclaimed_prize_countIntegerOptional
Optional. Number of undistributed prizes
only_new_membersTrueOptional
Optional. True, if only users who had joined the chats after the giveaway started were eligible to win
was_refundedTrueOptional
Optional. True, if the giveaway was canceled because the payment for it was refunded
prize_descriptionStringOptional
Optional. Description of additional giveaway prize

GramIO Usage

See Also