Gift

This object represents a gift that can be sent by the bot. ↗

13 fields, 3 required.

Fields

id string Required
Unique identifier of the gift.

sticker Sticker Required
The sticker that represents the gift.

star_count number Required
The number of Telegram Stars that must be paid to send the sticker.

upgrade_star_count number
The number of Telegram Stars that must be paid to upgrade the gift to a unique one.

is_premium boolean
True, if the gift can only be purchased by Telegram Premium subscribers.

has_colors boolean
True, if the gift can be used (after being upgraded) to customize a user’s appearance.

total_count number
The total number of gifts of this type that can be sent by all users; for limited gifts only.

remaining_count number
The number of remaining gifts of this type that can be sent by all users; for limited gifts only.

personal_total_count number
The total number of gifts of this type that can be sent by the bot; for limited gifts only.

personal_remaining_count number
The number of remaining gifts of this type that can be sent by the bot; for limited gifts only.

background GiftBackground
Background of the gift.

unique_gift_variant_count number
The total number of different unique gifts that can be obtained by upgrading the gift.

publisher_chat Chat
Information about the chat that published the gift.