--- title: "Get account leaderboard" method: POST path: "/v1/leaderboard.getAccountLeaderboard" tags: ["leaderboard"] --- # Get account leaderboard `POST /v1/leaderboard.getAccountLeaderboard` ## Request body - V1LeaderboardGetAccountLeaderboardRequestBody - `$schema` string, uri — A URL to the JSON Schema for this object. - `app` V1AccountLeaderboardAppSearch, nullable - `appId` integer — For a given app leaderboard, the app id - `badge` V1AccountLeaderboardBadgeSearch, nullable - `id` integer, required — The badge id to get the leaderboard for (appId) or id 1-64 - `isFoil` boolean, required — Whether the badge is foil or not - `end` integer, nullable — The end index - `goToLeaderboardRank` integer, nullable — The rank to go to - `leaderboard` 'apps' | 'app_playtime' | 'app_valid_playtime' | 'awards_given' | 'awards_received' | 'bans' | 'game_bans' | 'vac_bans' | 'donations' | 'foil_badges' | 'normal_badges' | 'badges' | 'playtime' | 'valid_playtime' | 'points_given' | 'points_received' | 'steam_sets' | 'xp' | 'badge_completion_time' | 'badge_highest_level', required — The leaderboard to get - `location` V1LeaderboardLocation[], nullable — The location(s)to get the leaderboard for, otherwise global - `city` string, nullable — The city to get the leaderboard for, otherwise global - `country` string, nullable — The country to get the leaderboard for, otherwise global - `region` string, nullable — The region to get the leaderboard for, otherwise global - `state` string, nullable — The state to get the leaderboard for, otherwise global - `start` integer, nullable — The start index ## Response `200` OK - V1LeaderboardGetAccountLeaderboardResponseBody - `$schema` string, uri — A URL to the JSON Schema for this object. - `accounts` V1AccountLeaderboardAccount[], nullable, required - `animatedAvatar` string, required — The animated avatar of the account - `appPlaytime` integer, nullable, required — For the app playtime leaderboard - `apps` integer, required — The number of apps the account has - `avatar` string, required — The avatar hash of the account - `avatarFrame` string, required — The avatar frame of the account - `awardsGiven` integer, required — The number of awards the account has - `awardsReceived` integer, required — The number of awards the account has - `background` string, required — The background of the account - `badgeInfo` AccountBadgeInfo, nullable - `completionTime` string, date-time, required — The time the badge was completed - `level` integer, required — The level of the badge - `xp` integer, required — The xp of the badge - `badges` integer, required — The number of badges the account has - `bans` integer, required — The number of bans - `city` LeaderboardCity, nullable - `name` string, required — The name of the city - `country` LeaderboardCountry, nullable - `code` string — The code of the country - `name` string, required — The name of the country - `createdAt` string, date-time, required — The time the account was created - `donated` integer, required — The total of donations the account has - `economyBan` string, required — The economy ban of the account - `foilBadges` integer, required — The number of foil badges the account has - `friends` integer, required — The number of friends the account has - `gameBans` integer, required — The number of game bans - `level` integer, required — The level of the account - `miniBackground` string, required — The mini background of the account - `name` string, required — The name of the account - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', required — Donator name effect, none when unset or the account no longer holds an entitling role - `normalBadges` integer, required — The number of normal badges the account has - `playtime` integer, required — The playtime of the account - `pointsGiven` integer, required — The number of points the account has - `pointsReceived` integer, required — The number of points the account has - `privacy` 'public' | 'private' | 'friends_only', required — The privacy of the account - `rank` integer, required — The rank of the account - `region` LeaderboardRegion, nullable - `name` string, required — The name of the region - `roles` Role[], nullable, required — The roles of the account - `extras` object, nullable, required — Extra data associated with the role - `rating` integer, required — The higher the more presedence it has - `role` 'user' | 'donator' | 'staff' | 'developer' | 'partner' | 'owner' | 'amethyst' | 'amber' | 'emerald' | 'sapphire' | 'ruby' | 'diamond' | 'contributor' | 'early_supporter' | 'beta' | 'translator' | 'top_100' | 'badge_scout' | 'nitro_booster' | 'astral' | 'nebula', required - `state` LeaderboardState, nullable - `name` string, required — The name of the state - `steamId` string, required — The steam id - `steamSetsScore` integer, required — The steam sets score - `steamSetsVanity` string, required — The vanity of the account - `steamVanity` string, required — The vanity of the account - `themeColor` string, nullable, required — Donator profile theme color as #RRGGBB (no alpha), null when unset or the account no longer holds an entitling role - `vacBans` integer, required — The number of vac bans - `xp` integer, required — The number of xp the account has - `app` V1LeaderboardAppInfo, nullable - `id` integer, required — The id of the app - `image` string, required — The image of the app - `name` string, required — The name of the app - `type` string, required — The type of the app - `badgeInfo` V1LeaderboardBadgeInfo, nullable - `appId` integer, required — The id of the app - `appImage` string, required — The image of the app - `appName` string, required — The name of the app - `image` string, required — The image of the badge - `isFoil` boolean, required — Whether the badge is foil or not - `level` integer, required — The level of the badge - `name` string, required — The name of the badge - `hiddenRanks` integer[], nullable — The ranks that are hidden in the leaderboard - `location` V1LeaderboardLocationInfo[], nullable - `cityName` string, nullable, required — The city name of the location - `countryCode` string, nullable, required — The country code of the location - `countryName` string, nullable, required — The country name of the location - `region` string, nullable, required — The region of the location - `stateName` string, nullable, required — The state name of the location - `ownAccount` V1AccountLeaderboardAccount, nullable - `animatedAvatar` string, required — The animated avatar of the account - `appPlaytime` integer, nullable, required — For the app playtime leaderboard - `apps` integer, required — The number of apps the account has - `avatar` string, required — The avatar hash of the account - `avatarFrame` string, required — The avatar frame of the account - `awardsGiven` integer, required — The number of awards the account has - `awardsReceived` integer, required — The number of awards the account has - `background` string, required — The background of the account - `badgeInfo` AccountBadgeInfo, nullable - `completionTime` string, date-time, required — The time the badge was completed - `level` integer, required — The level of the badge - `xp` integer, required — The xp of the badge - `badges` integer, required — The number of badges the account has - `bans` integer, required — The number of bans - `city` LeaderboardCity, nullable - `name` string, required — The name of the city - `country` LeaderboardCountry, nullable - `code` string — The code of the country - `name` string, required — The name of the country - `createdAt` string, date-time, required — The time the account was created - `donated` integer, required — The total of donations the account has - `economyBan` string, required — The economy ban of the account - `foilBadges` integer, required — The number of foil badges the account has - `friends` integer, required — The number of friends the account has - `gameBans` integer, required — The number of game bans - `level` integer, required — The level of the account - `miniBackground` string, required — The mini background of the account - `name` string, required — The name of the account - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', required — Donator name effect, none when unset or the account no longer holds an entitling role - `normalBadges` integer, required — The number of normal badges the account has - `playtime` integer, required — The playtime of the account - `pointsGiven` integer, required — The number of points the account has - `pointsReceived` integer, required — The number of points the account has - `privacy` 'public' | 'private' | 'friends_only', required — The privacy of the account - `rank` integer, required — The rank of the account - `region` LeaderboardRegion, nullable - `name` string, required — The name of the region - `roles` Role[], nullable, required — The roles of the account - `extras` object, nullable, required — Extra data associated with the role - `rating` integer, required — The higher the more presedence it has - `role` 'user' | 'donator' | 'staff' | 'developer' | 'partner' | 'owner' | 'amethyst' | 'amber' | 'emerald' | 'sapphire' | 'ruby' | 'diamond' | 'contributor' | 'early_supporter' | 'beta' | 'translator' | 'top_100' | 'badge_scout' | 'nitro_booster' | 'astral' | 'nebula', required - `state` LeaderboardState, nullable - `name` string, required — The name of the state - `steamId` string, required — The steam id - `steamSetsScore` integer, required — The steam sets score - `steamSetsVanity` string, required — The vanity of the account - `steamVanity` string, required — The vanity of the account - `themeColor` string, nullable, required — Donator profile theme color as #RRGGBB (no alpha), null when unset or the account no longer holds an entitling role - `vacBans` integer, required — The number of vac bans - `xp` integer, required — The number of xp the account has - `rankedOutOf` integer — The number of accounts that are ranked in the leaderboard ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `422` — Unprocessable Entity - `500` — Internal Server Error --- [API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/2e8ba266b27f/schema)