peyk.platforms.telegram.methods.get_user_gifts

async peyk.platforms.telegram.methods.get_user_gifts(self, user_id: int, *, exclude_unlimited: bool | None = None, exclude_limited_upgradable: bool | None = None, exclude_limited_non_upgradable: bool | None = None, exclude_from_blockchain: bool | None = None, exclude_unique: bool | None = None, sort_by_price: bool | None = None, offset: str | None = None, limit: int | None = None) → OwnedGifts

Returns the gifts owned and hosted by a user. Returns OwnedGifts on success.

Parameters:

  • user_id – Unique identifier of the user

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

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

  • exclude_limited_non_upgradable – Pass True to exclude gifts that can be purchased a limited number of times and can’t be upgraded to unique

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

  • exclude_unique – Pass True to exclude unique gifts

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

  • offset – 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 – The maximum number of gifts to be returned; 1-100. Defaults to 100.