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

# PFLeaderboardsGetEntityLeaderboardRequest

> Reference for the PFLeaderboardsGetEntityLeaderboardRequest struct in the PlayFab Services C API, with members to request a page of leaderboard rankings.

PFLeaderboardsGetEntityLeaderboardRequest data model. Request to load a leaderboard.

## Syntax

```cpp theme={null}
typedef struct PFLeaderboardsGetEntityLeaderboardRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* leaderboardName;  
    uint32_t pageSize;  
    uint32_t const* startingPosition;  
    uint32_t const* version;  
} PFLeaderboardsGetEntityLeaderboardRequest;  
```

### Members

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

(Optional) The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

**`customTagsCount`**   uint32\_t

Count of customTags

**`leaderboardName`**   const char\*\
*is null-terminated*

Name of the leaderboard.

**`pageSize`**   uint32\_t

Maximum number of results to return from the leaderboard. Minimum 1, maximum 100.

**`startingPosition`**   uint32\_t const\*\
*may be nullptr*

(Optional) Index position to start from. 1 is beginning of leaderboard.

**`version`**   uint32\_t const\*\
*may be nullptr*

(Optional) Optional version of the leaderboard, defaults to current version.

## Requirements

**Header:** PFLeaderboardsTypes.h

## See also

[PFLeaderboardsTypes members](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)


## Related topics

- [PFLeaderboardsGetLeaderboardAsync](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardasync.md)
- [Services C API overview - PFLeaderboardsTypes.h](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardForEntitiesRequest](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardforentitiesrequest.md)
- [PFLeaderboardsGetLeaderboardAroundEntityRequest](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardaroundentityrequest.md)
- [PFLeaderboardsGetFriendLeaderboardForEntityRequest](https://docs.xbox.com/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetfriendleaderboardforentityrequest.md)