# \*Leaderboard by factors
## Leaderboard
`GET` `https://leaderboard.telematicssdk.com/v1/Leaderboard`
This endpoint allows you to get a list of users with ranks\
\
**Authorization:** Allow Anonymous
#### Query Parameters
| Name | Type | Description |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UsersCount | integer | Number of TOP-X users. If you want to show TOP-5 users - UserCount = 5. |
| RoundUsersCount | integer | Number of users around the requested user position. |
| ScoringRate | integer | 1 - Acceleration score
2 - Braking Score
3 - Phone Usage Score
4 - Speeding Score
5 - Cornering Score
6 - Overall Score
7 - Distance
8 - Number of Trips
9 Driving Time
|
#### Headers
| Name | Type | Description |
| ----------- | ------ | ---------------- |
| DeviceToken | string | User deviceToken |
{% tabs %}
{% tab title="200 Cake successfully retrieved." %}
```
{
"Result": {
"UsersNumber": 61, // Total number of users in respose
"ScoringRate": "Acceleration", // Selected factor
"Users": [
{
"DeviceToken": "", // User device token
"Nickname": null, //Nickname
"FirstName": null,
"LastName": null,
"Image": "", // avatar image URL
"Value": 100, // Factor value
"Place": 1, // rank
"IsCurrentUser": false //if requested user = true
},
{
"DeviceToken": "",
"Nickname": null,
"FirstName": null,
"LastName": null,
"Image": "",
"Value": 100,
"Place": 2,
"IsCurrentUser": false
}
]
},
"Status": 200,
"Title": "",
"Errors": []
}
```
{% endtab %}
{% endtabs %}
{% hint style="info" %}
in case when a requested user is in a number of UsersCount, the response will contain only Users Count, otherwise it will be combined list UsersCount + RoundUserCount + requested user.
{% endhint %}
{% hint style="success" %}
The leaderboard contains ranking information based on the last 14 days driving data.
{% endhint %}
