> ## 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. # Get Leaderboard Around Character > Retrieves a list of ranked characters for the given statistic, centered on the requested Character ID ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | ProductDisabledForTitle | 1609 | ## OpenAPI ````yaml post /Client/GetLeaderboardAroundCharacter openapi: 3.0.0 info: version: '260922' title: PlayFab Client API description: >- APIs which provide the full range of PlayFab features available to the client - authentication, account and data management, inventory, friends, matchmaking, reporting, and platform-specific functionality termsOfService: https://playfab.com/terms/ contact: url: https://community.playfab.com/index.html license: name: Apache 2.0 url: https://github.com/PlayFab/API_Specs/blob/master/LICENSE servers: - url: https://{titleId}.playfabapi.com description: PlayFab title endpoint variables: titleId: default: your_title_id description: Your PlayFab title ID (hex). security: [] tags: - name: Account Management description: Account Management APIs - name: Advertising description: Advertising APIs - name: Analytics description: Analytics APIs - name: Authentication description: Authentication APIs - name: Character Data description: Character Data APIs - name: Characters description: Characters APIs - name: Content description: Content Service APIs - name: Friend List Management description: Friend List Management APIs - name: Matchmaking description: Matchmaking APIs - name: Platform Specific Methods description: Platform Specific Methods APIs - name: Player Data Management description: Player Data Management APIs - name: Player Item Management description: Player Item Management APIs - name: PlayStream description: PlayStream Management APIs - name: Server-Side Cloud Script description: Server-Side Cloud Script APIs - name: Shared Group Data description: Shared Group Data APIs - name: Title-Wide Data Management description: Title-Wide Data Management APIs - name: Trading description: Trading Management APIs paths: /Client/GetLeaderboardAroundCharacter: post: tags: - Characters summary: Get Leaderboard Around Character description: > Retrieves a list of ranked characters for the given statistic, centered on the requested Character ID ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | ProductDisabledForTitle | 1609 | operationId: GetLeaderboardAroundCharacter requestBody: content: application/json: schema: $ref: '#/components/schemas/GetLeaderboardAroundCharacterRequest' responses: '200': $ref: '#/components/responses/GetLeaderboardAroundCharacterResult' '400': $ref: '#/components/responses/ApiErrorWrapper' security: - SessionTicket: [] components: schemas: GetLeaderboardAroundCharacterRequest: type: object properties: CharacterId: description: >- Unique PlayFab assigned ID for a specific character on which to center the leaderboard. type: string MaxResultsCount: description: Maximum number of entries to retrieve. Default 10, maximum 100. type: number x-actualtype: int32 StatisticName: description: >- Unique identifier for the title-specific statistic for the leaderboard. type: string required: - StatisticName - CharacterId example: StatisticName: Kills CharacterId: '987343220' MaxResultsCount: 20 GetLeaderboardAroundCharacterResult: description: >- Note: When calling 'GetLeaderboardAround...' APIs, the position of the character defaults to 0 when the character does not have the corresponding statistic. type: object properties: Leaderboard: description: Ordered list of leaderboard entries. type: array items: $ref: '#/components/schemas/CharacterLeaderboardEntry' x-isclass: true example: Leaderboard: - PlayFabId: '10931252888739651331' CharacterId: '987343220' CharacterName: FighterDude DisplayName: username CharacterType: blue_warrior StatValue: 12 ApiErrorWrapper: description: The basic wrapper around every failed API response type: object properties: code: description: Numerical HTTP code type: integer status: description: String HTTP code type: string error: description: Playfab error code type: string errorCode: description: Numerical PlayFab error code type: integer errorMessage: description: Description for the PlayFab errorCode type: string errorDetails: description: Detailed description of individual issues with the request object type: object required: - code - errorCode CharacterLeaderboardEntry: type: object properties: CharacterId: description: >- PlayFab unique identifier of the character that belongs to the user for this leaderboard entry. type: string CharacterName: description: >- Title-specific display name of the character for this leaderboard entry. type: string CharacterType: description: Name of the character class for this entry. type: string DisplayName: description: Title-specific display name of the user for this leaderboard entry. type: string PlayFabId: description: PlayFab unique identifier of the user for this leaderboard entry. type: string Position: description: User's overall position in the leaderboard. type: number x-actualtype: int32 StatValue: description: Specific value of the user's statistic. type: number x-actualtype: int32 required: - StatValue - Position responses: GetLeaderboardAroundCharacterResult: description: >- Note: When calling 'GetLeaderboardAround...' APIs, the position of the character defaults to 0 when the character does not have the corresponding statistic. content: application/json: schema: type: object properties: code: type: integer description: >- The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code. status: type: string description: The Http status code as a string. data: $ref: '#/components/schemas/GetLeaderboardAroundCharacterResult' example: code: 200 status: OK data: Leaderboard: - PlayFabId: '10931252888739651331' CharacterId: '987343220' CharacterName: FighterDude DisplayName: username CharacterType: blue_warrior StatValue: 12 ApiErrorWrapper: description: This is the outer wrapper for all responses with errors content: application/json: schema: $ref: '#/components/schemas/ApiErrorWrapper' securitySchemes: SessionTicket: type: apiKey in: header name: X-Authorization description: >- This API requires a client session ticket, available from any Client Login function. ```` ## Related topics - [Get Leaderboard Around Character](/api-reference/characters/get-leaderboard-around-character.md) - [Get Leaderboard Around Entity](/services/playfab/api-references/rest/progression/leaderboards/get-leaderboard-around-entity.md) - [Get Leaderboard Around User](/services/playfab/api-references/rest/server/player-data-management/get-leaderboard-around-user.md) - [Get Leaderboard Around Player](/services/playfab/api-references/rest/client/player-data-management/get-leaderboard-around-player.md) - [PFLeaderboardsGetLeaderboardAroundEntityAsync](/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentityasync.md)