Returns: List[GameHighScore]

class aiogram.methods.get_game_high_scores.GetGameHighScores(*, user_id: int, chat_id: Optional[int] = None, message_id: Optional[int] = None, inline_message_id: Optional[str] = None, **extra_data: Any)[source]#

Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. Returns an Array of aiogram.types.game_high_score.GameHighScore objects.

This method will currently return scores for the target user, plus two of their closest neighbors on each side. Will also return the top three users if the user and their neighbors are not among them. Please note that this behavior is subject to change.


user_id: int#

Target user id

chat_id: Optional[int]#

Required if inline_message_id is not specified. Unique identifier for the target chat

message_id: Optional[int]#

Required if inline_message_id is not specified. Identifier of the sent message

inline_message_id: Optional[str]#

Required if chat_id and message_id are not specified. Identifier of the inline message

build_request(bot: Bot) Request[source]#


As bot method#

result: List[GameHighScore] = await bot.get_game_high_scores(...)

Method as object#


  • from aiogram.methods.get_game_high_scores import GetGameHighScores

  • alias: from aiogram.methods import GetGameHighScores

With specific bot#

result: List[GameHighScore] = await bot(GetGameHighScores(...))