# Giveaway

Source: https://core.telegram.org/bots/api#giveaway

[Documentation index](../llms.txt)

This object represents a message about a scheduled giveaway.

| Field | Type | Description |
| --- | --- | --- |
| chats | Array of [Chat](chat.md) | The list of chats which the user must join to participate in the giveaway |
| winners\_selection\_date | Integer | Point in time (Unix timestamp) when winners of the giveaway will be selected |
| winner\_count | Integer | The number of users which are supposed to be selected as winners of the giveaway |
| only\_new\_members | True | *Optional*. *True*, if only users who join the chats after the giveaway started should be eligible to win |
| has\_public\_winners | True | *Optional*. *True*, if the list of giveaway winners will be visible to everyone |
| prize\_description | String | *Optional*. Description of additional giveaway prize |
| country\_codes | Array of String | *Optional*. A list of two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways. |
| prize\_star\_count | Integer | *Optional*. The number of Telegram Stars to be 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 |