> ## 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.

# Leaderboards Meters

> Learn how PlayFab Leaderboards billable meters work, what operations they count, and how leaderboard activity contributes to service charges.

Leaderboards meters are divided into three categories.

## Leaderboard Reads

Whether based on ranked stats or otherwise, Leaderboard Reads are dependent on the size of a leaderboard in the API response. If a request returns N entries, then the meter is ticked N/10 times, rounded up. Note that *N* is influenced by the request parameters and leaderboard size and also if N \< 10 the meter is going to tick once.

Here's the list of APIs that tick this meter:

| API Name                      | API Reference                                                                                                                                                                                                   |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GetFriendLeaderboardForEntity | [/rest/api/services/playfab/progression/leaderboards/get-friend-leaderboard-for-entity](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-friend-leaderboard-for-entity) |
| GetLeaderboard                | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard)                                     |
| GetLeaderboardAroundEntity    | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard-around-entity](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard-around-entity)         |
| GetLeaderboardForEntities     | [/rest/api/services/playfab/progression/leaderboards/get-leaderboard-for-entities](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/get-leaderboard-for-entities)           |

## Leaderboard Writes

A request to update N entries on a standalone leaderboard (for example, those leaderboards not based on ranked stats), ticks the Leaderboard Meter N times. For leaderboards based on ranked stats, both the Statistic Write and Leaderboards Write meter are impacted. For more information, see Statistic Write.

Here's the list of APIs that tick this meter:

| API Name                 | API Reference                                                                                                                                                                                     |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UpdateLeaderboardEntries | [/rest/api/services/playfab/progression/leaderboards/update-leaderboard-entries](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/leaderboards/update-leaderboard-entries) |

## Leaderboard Storage

This meter keeps track on how much leaderboards data is stored in the service.

For each leaderboard entry, the storage consumed is computed as the sum of the following elements:

* Scores: Length of the list of scores multiplied by `sizeof(long)`.
* Metadata: Length of the field.
* Timestamp: `sizeof(long)`.
* Length of the entity id.

## See Also

* [statistics-meters.md](/services/playfab/pricing/meters/statistics-meters).


## Related topics

- [Statistics Meters](/services/playfab/pricing/meters/statistics-meters.md)
- [Quota Leaderboards](/services/playfab/community/leaderboards/quota-leaderboards.md)
- [Limits on Leaderboards](/services/playfab/community/leaderboards/limits-leaderboards.md)
- [Quickstart on leaderboards](/services/playfab/community/leaderboards/quickstart-leaderboards.md)
- [API Leaderboard reference](/services/playfab/community/leaderboards/api-reference.md)