# GiveawayWinners

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

**Category:** Telegram Bot API — Types (A-Z)  
**URL:** https://docs.botlify.cloud/giveawaywinners  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

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

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| chat | Chat | Always | The chat that created the giveaway |
| giveaway_message_id | Integer | Always | Identifier of the message with the giveaway in the chat |
| winners_selection_date | Integer | Always | Point in time (Unix timestamp) when winners of the giveaway were selected |
| winner_count | Integer | Always | Total number of winners in the giveaway |
| winners | Array of User | Always | List of up to 100 winners of the giveaway |
| additional_chat_count | Integer | Optional | The number of other chats the user had to join in order to be eligible for the giveaway |
| prize_star_count | Integer | Optional | The number of Telegram Stars that were split between giveaway winners; for Telegram Star giveaways only |
| premium_subscription_month_count | Integer | Optional | The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only |
| unclaimed_prize_count | Integer | Optional | Number of undistributed prizes |
| only_new_members | True | Optional | True, if only users who had joined the chats after the giveaway started were eligible to win |
| was_refunded | True | Optional | True, if the giveaway was canceled because the payment for it was refunded |
| prize_description | String | Optional | Description of additional giveaway prize |

> [!TIP]
> **Botlify Cloud Runtime**
> Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.