getChatGifts
Returns OwnedGifts ↗
Returns the gifts owned by a chat.
Required: chat_id · Optional: 10 parameters
Try it
TypeScript example · @effect-ak/tg-bot-client
import { makeTgBotClient } from "@effect-ak/tg-bot-client"
const client = makeTgBotClient({ bot_token: "YOUR_BOT_TOKEN" })
const result = await client.execute("get_chat_gifts", { chat_id: "YOUR_CHAT_ID"})Parameters
chat_id number | string Required
Unique identifier for the target chat or username of the target channel (in the format @channelusername).
exclude_unsaved boolean
Pass True to exclude gifts that aren’t saved to the chat’s profile page. Always True, unless the bot has the can_post_messages administrator right in the channel.
exclude_saved boolean
Pass True to exclude gifts that are saved to the chat’s profile page. Always False, unless the bot has the can_post_messages administrator right in the channel.
exclude_unlimited boolean
Pass True to exclude gifts that can be purchased an unlimited number of times.
exclude_limited_upgradable boolean
Pass True to exclude gifts that can be purchased a limited number of times and can be upgraded to unique.
exclude_limited_non_upgradable boolean
Pass True to exclude gifts that can be purchased a limited number of times and can’t be upgraded to unique.
exclude_from_blockchain boolean
Pass True to exclude gifts that were assigned from the TON blockchain and can’t be resold or transferred in Telegram.
exclude_unique boolean
Pass True to exclude unique gifts.
sort_by_price boolean
Pass True to sort results by gift price instead of send date. Sorting is applied before pagination.
offset string
Offset of the first entry to return as received from the previous request; use an empty string to get the first chunk of results.
limit number
The maximum number of gifts to be returned; 1-100. Defaults to 100.
Related methods
getAvailableGifts · getBusinessAccountGifts · getBusinessAccountStarBalance · getBusinessConnection · getChat · getChatAdministrators · getChatMember · getChatMemberCount · getChatMenuButton · getCustomEmojiStickers · getFile · getForumTopicIconStickers · getGameHighScores · getMe · getMyCommands · getMyDefaultAdministratorRights · getMyDescription · getMyName · getMyShortDescription · getMyStarBalance · getStarTransactions · getStickerSet · getUpdates · getUserChatBoosts · getUserGifts · getUserProfileAudios · getUserProfilePhotos · getWebhookInfo