Leaderboards

List leaderboards

Every leaderboard, how many players it has and when it changed.

GET/v1/leaderboards

Lists the six DonutSMP leaderboards (money, deaths, playtime, blocks placed, blocks broken and mobs killed), two boards DonutStats ranks itself (kills and shards, which DonutSMP has no leaderboard for) and the bounty board.

Authentication

API key with the read scope

Cached for

30 s

Data updates

DonutSMP boards every 6 hours. Kills and shards with every lookup. Bounties every 15 minutes.

curl "https://api.donutstats.io/v1/leaderboards" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "boards": [
    {
      "id": "money",
      "label": "Money",
      "stat": "money",
      "source": "leaderboard",
      "updatedAt": 1792694462533,
      "entries": 89727
    },
    {
      "id": "deaths",
      "label": "Deaths",
      "stat": "deaths",
      "source": "leaderboard",
      "updatedAt": 1792722232417,
      "entries": 1125
    }
  ]
}

Try itCounts towards your plan

This endpoint takes no parameters.

Response

Every board.

boardsBoard[]
In a fixed order.
ShowHide6 child fields
- idstring
  Board id: money, deaths, playtime, placedBlocks, brokenBlocks, mobsKilled, kills, shards or bounties.
- labelstring
  Human readable name, for example Blocks Placed.
- statstring
  The stat the board ranks, or bounty.
- sourcestring
  leaderboard for DonutSMP's own leaderboards, tracked for boards DonutStats ranks itself (kills and shards, which DonutSMP has no leaderboard for), bounty for the bounty board.
- updatedAttimestamp | null
  When the board last changed.
- entriesinteger
  Players on the board.