Sign in
Telegram Bot API

Changed on

Returns the gifts received and owned by a managed business account. Requires the can_view_gifts_and_stars business bot right. Returns OwnedGifts on success.

post/getBusinessAccountGifts

Request

  • Base URL: https://api.telegram.org/bot<bot_token>
  • URL: https://api.telegram.org/bot<bot_token>/getBusinessAccountGifts
  • Auth: none declared

Request body

business_connection_idstring required

Unique identifier of the business connection

exclude_unsavedboolean

Pass True to exclude gifts that aren't saved to the account's profile page

exclude_savedboolean

Pass True to exclude gifts that are saved to the account's profile page

exclude_unlimitedboolean

Pass True to exclude gifts that can be purchased an unlimited number of times

exclude_limited_upgradableboolean

Pass True to exclude gifts that can be purchased a limited number of times and can be upgraded to unique

exclude_limited_non_upgradableboolean

Pass True to exclude gifts that can be purchased a limited number of times and can't be upgraded to unique

exclude_uniqueboolean

Pass True to exclude unique gifts

exclude_from_blockchainboolean

Pass True to exclude gifts that were assigned from the TON blockchain and can't be resold or transferred in Telegram

sort_by_priceboolean

Pass True to sort results by gift price instead of send date. Sorting is applied before pagination.

offsetstring

Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results

limitinteger

The maximum number of gifts to be returned; 1-100. Defaults to 100.

Response

Telegram API response

oktrue required

Changes

  • e4c250383b33Revision changes
    • info

      added the optional property /////////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status