Limits on Leaderboards - XBOX Game Development Documentation

The purpose of this guide is to detail the limits that are enforced when creating, updating, and reading from your leaderboards on the Leaderboards service.

Caller: This type of limit is enforced on the caller of the API. This constraint could be either a player or a title.
Target: This type of limit is enforced on the target of the API, in our specific case an entity.

The following table outlines the limits for the various APIs available in the Leaderboards service. If an API isn’t explicitly listed here, the default behavior is applied.

API	Limit	Caller	Target entity
Default	50 requests per 120 seconds	Player	`title_player_account` , `master_player_account`, `group`, `character`
GetLeaderboard	30 requests per 120 seconds / 1,200 requests per 120 seconds	Player / Title	N/A
GetLeaderboardAroundEntity	30 requests per 120 seconds	Player	`title_player_account`, `master_player_account` , `group`, `character`
GetFriendLeaderboardForEntity	30 requests per 120 seconds	Player	`title_player_account`, `master_player_account` , `group`, `character`
GetLeaderboardDefinition	30 requests per 120 seconds	Title	N/A
ListLeaderboardDefinitions	30 requests per 120 seconds	Title	N/A
CreateLeaderboardDefinition	30 requests per 120 seconds	Title	N/A
UnlinkLeaderboardFromStatistic	30 requests per 120 seconds	Title	N/A
IncrementLeaderboardVersion	30 requests under 2 minutes	Title	N/A

Limits on Leaderboard Events

playfab.leaderboard.entity_rank_on_leaderboard_version_ended
- Only return up to the top 1000 ranks.
- Will not work with leaderboards with a entity type of master_player_account or external.

See also

Last modified on August 4, 2026

Related topics

PlayFab Community documentation Leaderboards with PlayStream and Telemetry Quota Leaderboards Leaderboards Seasonal leaderboards

⌘I