---
title: "General leaderboard"
method: GET
path: "/v1/Leaderboard"
---

# General leaderboard

`GET /v1/Leaderboard`

## Request

- Base URL: `https://leaderboard.telematicssdk.com`
- URL: `https://leaderboard.telematicssdk.com/v1/Leaderboard`
- Auth: none required

**[Required level of authorization:](https://docs.telematicssdk.com/reference#api-get-started)**
* no authorization required

## Query parameters

- `UsersCount` integer, required
- `RoundUsersCoun` integer, required
- `Scoringrate` integer

## Headers

- `DeviceToken` string, required

## Response `200`

200

- object
  - `Result` object
    - `UsersNumber` integer
    - `ScoringRate` string
    - `Users` object[]
      - `DeviceToken` string
      - `Nickname` string
      - `FirstName` unknown
      - `LastName` unknown
      - `Image` string
      - `Value` integer
      - `ValuePerc` number
      - `Place` integer
      - `IsCurrentUser` boolean
      - `Distance` number
      - `Duration` number
      - `Trips` integer
  - `Status` integer
  - `Title` string
  - `Errors` object[]

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/damoov/apis/engagement-services-leaderboard.md) - [All operations](https://skmtc.dev/damoov/apis/engagement-services-leaderboard/llms.txt) - [OpenAPI document](https://skmtc.dev/damoov/apis/engagement-services-leaderboard/revisions/42681621aca2?raw)