GiveawayWinners

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

12 fields, 5 required.

Fields

chat Chat Required
The chat that created the giveaway.

giveaway_message_id number Required
Identifier of the message with the giveaway in the chat.

winners_selection_date number Required
Point in time (Unix timestamp) when winners of the giveaway were selected.

winner_count number Required
Total number of winners in the giveaway.

winners User[] Required
List of up to 100 winners of the giveaway.

additional_chat_count number
The number of other chats the user had to join in order to be eligible for the giveaway.

prize_star_count number
The number of Telegram Stars that were split between giveaway winners; for Telegram Star giveaways only.

premium_subscription_month_count number
The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only.

unclaimed_prize_count number
Number of undistributed prizes.

only_new_members boolean
True, if only users who had joined the chats after the giveaway started were eligible to win.

was_refunded boolean
True, if the giveaway was canceled because the payment for it was refunded.

prize_description string
Description of additional giveaway prize.