---
title: "Get leaderboard"
method: GET
path: "/api/leaderboard"
tags: ["Leaderboard", "Gamification"]
---

# Get leaderboard

`GET /api/leaderboard`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/leaderboard`
- Auth: HTTP bearer

Returns leaderboard entries. Query: leaderboardId (number) or teamId (string); omit for global. The global / D-Sports board ranks each fan's total Fan Rep (same as profile fanRep: lifetime PointsHistory + typed Rep ledger), not a separate seasonal pool. Club team boards remain seasonal.

## Query parameters

- `leaderboardId` integer
- `teamId` string

## Response `200`

{ leaderboard, leaderboardEntries, currentUserId, season }

## Other responses

- `401`: Authentication required
- `404`: Leaderboard or user not found

## Changes

- **2026-03-12** `099fcb1a1540`: 1 info
  - api tag `Gamification` added
- **2026-03-08** `120afc4ee72c`: 1 breaking, 3 info
  - removed the media type `application/json` for the response with the status `200`
  - the endpoint scheme security `bearerAuth` was added to the API
  - api tag `Leaderboard` added
  - added the non-success response with the status `404`
- **2026-03-08** `ca10899d061e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/leaderboard/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
