# The taClient.getLeaderboard() method
This documents the `taClient.getLeaderboard()` method.

<div class="info-box">
    <span class="material-icons">info</span>
    <div>
        <strong>Async:</strong> This is a method you would want to use await with
    </div>
</div>

This method has input parameters. The function could easily be defined as:
```ts
async function getLeaderboard(qualifierId: string, mapId: string): Promise<Response> {
    // backend logic
}
```

## Parameters:
- **qualifierId** (string): The GUID of the qualifier event
- **mapId** (string): The GUID of the map within the qualifier for which to retrieve the leaderboard

## General usage:
```ts
const response: Response = taClient.getLeaderboard(qualifierGuid, mapGuid);
```
- For `Response` please find documentation at [Models -> Response](/documentation#Models/4-Response)

If you have not yet, please read [Client -> Introduction to the Client](/documentation#Client/3-client-intro)

## Standard Response:
```js
{
    details: {
        getLeaderboard: Response_GetLeaderboard,
        oneofKind: 'getLeaderboard'
    },
    respondingToPacketId: 'packet-guid-uuidv4',
    type: Response_ResponseType
}
```
- For `Response_GetLeaderboard` please find documentation at [Models -> Response_GetLeaderboard](/documentation#Models/4-Response_GetLeaderboard).

<div class="info-box">
    <span class="material-icons">info</span>
    <div>
        <strong>Note:</strong> This method retrieves the complete leaderboard for a specific map within a qualifier event, including all player scores sorted according to the leaderboard sort settings.
    </div>
</div>