Saltar al contenido principal
GET
/
leaderboards
JavaScript
import { TrophyApiClient } from '@trophyso/node';

const trophy = new TrophyApiClient({
  apiKey: 'YOUR_API_KEY'
});

const response = await trophy.leaderboards.all();
[
  {
    "id": "5100fe51-6bce-6j44-b0hs-bddc4e123682",
    "name": "Weekly Word Count Challenge",
    "key": "weekly-words",
    "rankBy": "metric",
    "metricKey": "words-written",
    "metricName": "Words Written",
    "description": "Compete weekly to see who writes the most words",
    "status": "active",
    "start": "2025-01-01",
    "end": null,
    "maxParticipants": 100,
    "breakdownAttribute": null,
    "runUnit": "day",
    "runInterval": 7
  },
  {
    "id": "5100fe51-6bce-6j44-b0hs-bddc4e123683",
    "name": "XP Leaderboard",
    "key": "xp-board",
    "rankBy": "points",
    "pointsSystemKey": "xp-system",
    "pointsSystemName": "Experience Points",
    "description": "Overall ranking by XP earned",
    "status": "active",
    "start": "2025-01-01",
    "end": null,
    "maxParticipants": 50,
    "breakdownAttribute": null,
    "runUnit": null,
    "runInterval": null
  }
]
Límites de velocidad

Autorizaciones

​
X-API-KEY
string
header
requerido

Parámetros de consulta

​
includeFinished
boolean
predeterminado:false

When set to 'true', leaderboards with status 'finished' will be included in the response. By default, finished leaderboards are excluded.

Respuesta

Successful operation

​
id
string
requerido

The unique ID of the leaderboard.

Ejemplo:

"5100fe51-6bce-6j44-b0hs-bddc4e123682"

​
name
string
requerido

The user-facing name of the leaderboard.

Ejemplo:

"Weekly Word Count Challenge"

​
key
string
requerido

The unique key used to reference the leaderboard in APIs.

Ejemplo:

"weekly-words"

​
rankBy
enum<string>
requerido

What the leaderboard ranks by.

Opciones disponibles:
points,
streak,
metric
Ejemplo:

"metric"

​
breakdownAttribute
string | null
requerido

The key of the attribute to break down this leaderboard by.

Ejemplo:

"country"

​
description
string | null
requerido

The user-facing description of the leaderboard.

Ejemplo:

"Compete weekly to see who writes the most words"

​
start
string<date>
requerido

The start date of the leaderboard in YYYY-MM-DD format.

Ejemplo:

"2025-01-01"

​
end
string<date> | null
requerido

The end date of the leaderboard in YYYY-MM-DD format, or null if it runs forever.

Ejemplo:

"2025-12-31"

​
maxParticipants
integer
requerido

The maximum number of participants in the leaderboard.

Ejemplo:

100

​
runUnit
enum<string> | null
requerido

The repetition type for recurring leaderboards, or null for one-time leaderboards.

Opciones disponibles:
day,
month,
year,
null
Ejemplo:

"day"

​
runInterval
integer | null
requerido

The interval between repetitions, relative to the start date and repetition type. Null for one-time leaderboards.

Ejemplo:

7

​
status
enum<string>
requerido

The status of the leaderboard.

Opciones disponibles:
active,
scheduled,
finished
Ejemplo:

"active"

​
metricKey
string

The key of the metric to rank by, if rankBy is 'metric'.

Ejemplo:

"words-written"

​
metricName
string

The name of the metric to rank by, if rankBy is 'metric'.

Ejemplo:

"Words Written"

​
pointsSystemKey
string

The key of the points system to rank by, if rankBy is 'points'.

Ejemplo:

"xp-system"

​
pointsSystemName
string

The name of the points system to rank by, if rankBy is 'points'.

Ejemplo:

"Experience Points"