> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limits on Leaderboards

> Rate limits and per-API request quotas for the PlayFab Leaderboards service, covering caller and target entity throttles across create, read, and update calls.

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

* [Create basic leaderboard](/services/playfab/community/leaderboards/create-basic-leaderboard)
* [Doing more with leaderboards](/services/playfab/community/leaderboards/doing-more-with-leaderboards)
* [Seasonal leaderboards](/services/playfab/community/leaderboards/seasonal-leaderboards)
* [Quota ](/services/playfab/community/leaderboards/quota-leaderboards)
* [Group leaderboards](/services/playfab/community/leaderboards/group-leaderboards)
* [Manual tiers](/services/playfab/community/leaderboards/manual-tiers)
* [Ranking players by statistics](/services/playfab/community/leaderboards/leaderboards-linked-to-stats)
* [Add contextual data to leaderboards](/services/playfab/community/leaderboards/metadata-leaderboards)
* [API reference](/services/playfab/community/leaderboards/api-reference)
* [Leaderboard meters](/services/playfab/pricing/meters/leaderboard-meters)
* [Leaderboards and Cloudscript](/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [Leaderboards with Playstream](/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [PlayFab Community documentation](/services/playfab/community/index.md)
- [Leaderboards with PlayStream and Telemetry](/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [Quota Leaderboards](/services/playfab/community/leaderboards/quota-leaderboards.md)
- [Leaderboards](/build/steam-porting-guide/features/steam-leaderboards.md)
- [Seasonal leaderboards](/services/playfab/community/leaderboards/seasonal-leaderboards.md)